---
title: "TOP100: frazy (`getKeywords`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-tool-top100-getKeywords
api: POST /api/serp_analysis/tools/top100_crawl/getKeywords
---

# TOP100: frazy (`getKeywords`)

**`POST /api/serp_analysis/tools/top100_crawl/getKeywords`**

Przykładowe żądanie:

```json
{
  "task_id": null,
  "limit": 10
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "keyword": "buty",
      "searches": 110000,
      "cpc_min": 0.71,
      "cpc_max": 2.47,
      "cpc_avg": 1.59,
      "snippets": [
        "image_thumbs",
        "people_also_ask",
        "popular_products",
        "related_searches"
      ],
      "domains_number": "82"
    }
  ],
  "pagination": {
    "page_count": 1,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": 1,
    "limit": 10
  }
}
```

Zwraca **frazy zadania TOP100** z metrykami (wyszukiwania, CPC z zakresem) oraz liczbą domen w wynikach (`domains_number`) i typami snippetów. Wymaga gotowego zadania [`top100_crawl`](/modules/serp_analysis/serp-tool-top100-create).

| Fraza | Wyszukiwania | CPC (śr.) | CPC min | CPC max | Liczba domen |
| --- | --- | --- | --- | --- | --- |
| buty | 110000 | 1.59 | 0.71 | 2.47 | 82 |

_fraza buty, PL._

---

## Żądanie

`POST` `/api/serp_analysis/tools/top100_crawl/getKeywords`

```jsonc filename="żądanie.jsonc"
{ "task_id": null, "limit": 10, "page": 1 }
```

### Parametry

```ts
type Top100GetKeywordsRequest = {
/** **Wymagane**. ID gotowego zadania top100_crawl. Realny `task_id` pobierzesz z `POST /api/tasks/management/top100_crawl/list` albo z odpowiedzi `create`. */
task_id: number;
limit?: number;
page?: number;
}
export default Top100GetKeywordsRequest
```

## Odpowiedź

```ts
type Top100GetKeywordsResponse = {
success: boolean;
data: Array<{
  keyword: string;
  searches: number;
  cpc_min: number;
  cpc_max: number;
  cpc_avg: number;
  snippets: string[];
  /** Liczba domen w wynikach (string). */
  domains_number: string;
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default Top100GetKeywordsResponse
```

## Błędy

Błędy tego endpointu przychodzą we [wspólnej kopercie ze statusem `418`](/types/errors).

## Powiązane akcje

- [`top100_crawl/getDomains`](/modules/serp_analysis/serp-tool-top100-getDomains) — domeny w TOP100 dla frazy.
- [`top100_crawl/getData`](/modules/serp_analysis/serp-tool-top100-getData) — pełne dane (fraza × URL).