---
title: "Baza słów kluczowych: domeny w wynikach (`getDomainsList`)"
source: https://docs.senuto.com/modules/keywords_analysis/ka-keywords-getDomainsList
api: POST /api/keywords_analysis/reports/keywords/getDomainsList
---

# Baza słów kluczowych: domeny w wynikach (`getDomainsList`)

**`POST /api/keywords_analysis/reports/keywords/getDomainsList`**

Przykładowe żądanie:

```json
{
  "parameters": [
    {
      "data_fetch_mode": "keyword",
      "value": [
        "buty do biegania"
      ]
    }
  ],
  "match_mode": "wide",
  "country_id": 1,
  "limit": 10
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "count": 6604,
      "name": "allegro.pl"
    },
    {
      "count": 5665,
      "name": "ceneo.pl"
    },
    {
      "count": 3767,
      "name": "zalando.pl"
    }
  ],
  "pagination": {
    "page_count": 2386,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 7157,
    "limit": 3
  }
}
```

Zwraca **domeny rankujące** w zbiorze fraz pasujących do zapytania, wraz z liczbą fraz (`count`), na które dana domena występuje. Pozwala szybko zobaczyć, którzy gracze dominują w danym temacie. Request identyczny jak w [`keywords/getKeywords`](/modules/keywords_analysis/ka-keywords-getKeywords).

| Domena | Liczba fraz |
| --- | --- |
| allegro.pl | 6604 |
| ceneo.pl | 5665 |
| zalando.pl | 3767 |

_parameters keyword „buty do biegania”, match_mode wide, country_id 1. Wszystkie pola wiersza._

> **Ostrzeżenie:**
> Uruchomienie zużywa jednostkę `keywords_analysis_queries_per_day` — patrz [Limity zapytań](/rate-limits).

---

## Żądanie

`POST` `/api/keywords_analysis/reports/keywords/getDomainsList`

```jsonc filename="żądanie.jsonc"
{
  "parameters": [{ "data_fetch_mode": "keyword", "value": ["buty do biegania"] }],
  "match_mode": "wide",
  "country_id": 1,
  "limit": 10
}
```

### Parametry

Jak w [`keywords/getKeywords`](/modules/keywords_analysis/ka-keywords-getKeywords): `parameters[{ data_fetch_mode, value[] }]`, `match_mode`, `country_id`, `limit`/`page`.

Obsługuje też opcjonalne **`filtering`** — zawęża zbiór fraz _przed_ zliczeniem domen (składnia i dozwolone klucze jak w [sekcji „Filtrowanie i sortowanie" w `getKeywords`](/modules/keywords_analysis/ka-keywords-getKeywords#filtrowanie-i-sortowanie); nieznany `key` → `418` `invalid_filtering`). **Nie obsługuje `order`** — kolejność jest stała (malejąco po liczbie fraz).

```jsonc filename="z filtrem (frazy ≥ 100 000 wyszukiwań/mies.)"
{
  "parameters": [{ "data_fetch_mode": "keyword", "value": ["buty do biegania"] }],
  "match_mode": "wide",
  "country_id": 1,
  "filtering": [{ "filters": [{ "key": "searches", "match": "gte", "value": 100000 }], "conjunction": "and" }]
}
```

## Odpowiedź

```ts
type KeywordsGetDomainsListResponse = {
success: boolean;
data: Array<{ name: string; count: number }>;
pagination: { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number };
}
export default KeywordsGetDomainsListResponse
```

## Błędy

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

## Powiązane akcje

- `keywords/getKeywords` — frazy w zbiorze.
- `keywords/getResultsStatistics` — statystyki zbiorcze zbioru fraz.