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

# TOP100: domeny (`getDomains`)

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

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "pos": 1,
      "domain": "butosklep.pl",
      "main_domain": "butosklep.pl",
      "url": "https://butosklep.pl/obuwie-damskie"
    },
    {
      "pos": 2,
      "domain": "www.filippo.pl",
      "main_domain": "filippo.pl",
      "url": "https://www.filippo.pl/pl/menu/damskie-245"
    }
  ],
  "pagination": {
    "page_count": 17,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 82,
    "limit": 10
  }
}
```

Zwraca **domeny/URL-e w TOP100** dla wybranej frazy zadania (`keyword`) wraz z pozycją. Wymaga gotowego zadania [`top100_crawl`](/modules/serp_analysis/serp-tool-top100-create).

| Pozycja | Domena | Domena główna | URL |
| --- | --- | --- | --- |
| 1 | butosklep.pl | butosklep.pl | https://butosklep.pl/obuwie-damskie |
| 2 | www.filippo.pl | filippo.pl | https://www.filippo.pl/pl/menu/damskie-245 |

_fraza buty, PL._

> **Informacja:**
> `keyword` jest wymagane (jedna z fraz zadania). Wymaga `task_id` gotowego zadania.

---

## Żądanie

`POST` `/api/serp_analysis/tools/top100_crawl/getDomains`

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

### Parametry

```ts
type Top100GetDomainsRequest = {
/** **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;
/** **Wymagane**. Fraza (jedna z fraz zadania). */
keyword: string;
limit?: number;
page?: number;
}
export default Top100GetDomainsRequest
```

## Odpowiedź

```ts
type Top100GetDomainsResponse = {
success: boolean;
data: Array<{
  pos: number;
  domain: string;
  main_domain: string;
  url: string;
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default Top100GetDomainsResponse
```

## Błędy

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

## Powiązane akcje

- [`top100_crawl/getKeywords`](/modules/serp_analysis/serp-tool-top100-getKeywords) — frazy zadania.
- [`top100_crawl/getData`](/modules/serp_analysis/serp-tool-top100-getData) — pełne dane (fraza × URL).