---
title: "TOP100: pełne dane (`getData`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-tool-top100-getData
api: POST /api/serp_analysis/tools/top100_crawl/getData
---

# TOP100: pełne dane (`getData`)

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

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "keyword": "buty",
      "url": "https://butosklep.pl/obuwie-damskie",
      "searches": 110000,
      "cpc_min": 0.71,
      "cpc_max": 2.47,
      "cpc_avg": 1.59,
      "pos": 1,
      "domain": "butosklep.pl",
      "main_domain": "butosklep.pl",
      "snippets": [
        "image_thumbs",
        "people_also_ask",
        "popular_products",
        "related_searches"
      ]
    }
  ],
  "pagination": {
    "page_count": 17,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 82,
    "limit": 10
  }
}
```

Zwraca **pełne wiersze `fraza × URL`** z zadania TOP100: pozycję w wynikach, domenę, metryki frazy (wyszukiwania, CPC) oraz typy snippetów. To najbardziej szczegółowy raport narzędzia — łączy dane fraz i domen. Wymaga gotowego zadania [`top100_crawl`](/modules/serp_analysis/serp-tool-top100-create).

| Pozycja | Fraza | Domena | URL | Wyszukiwania | CPC (śr.) |
| --- | --- | --- | --- | --- | --- |
| 1 | buty | butosklep.pl | https://butosklep.pl/obuwie-damskie | 110000 | 1.59 |
| 2 | buty | www.filippo.pl | https://www.filippo.pl/pl/menu/damskie-245 | 110000 | 1.59 |

_fraza buty, PL._

---

## Żądanie

`POST` `/api/serp_analysis/tools/top100_crawl/getData`

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

### Parametry

```ts
type Top100GetDataRequest = {
/** **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 Top100GetDataRequest
```

## Odpowiedź

```ts
type Top100GetDataResponse = {
success: boolean;
data: Array<{
  keyword: string;
  url: string;
  searches: number;
  cpc_min: number;
  cpc_max: number;
  cpc_avg: number;
  pos: number;
  domain: string;
  main_domain: string;
  snippets: string[];
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default Top100GetDataResponse
```

## Błędy

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

## Powiązane akcje

- [Eksport TOP100 (CSV)](/modules/serp_analysis/serp-export-top100) — eksport tych danych do pliku.
- [`top100_crawl/getKeywords`](/modules/serp_analysis/serp-tool-top100-getKeywords) — widok fraz.