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

POST/api/keywords_analysis/reports/keywords/getDomainsList

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.

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.

Uruchomienie zużywa jednostkę keywords_analysis_queries_per_day — patrz Limity zapytań.

Żądanie

POST /api/keywords_analysis/reports/keywords/getDomainsList

żądanie.jsonc


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

Parametry

Jak w 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; nieznany key → 418 invalid_filtering). Nie obsługuje order — kolejność jest stała (malejąco po liczbie fraz).

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ź

Name	Type	Default
`success`	`boolean`
`data`	`{ name: string; count: number; }[]`
`pagination`	`{ page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number; }`

Błędy

Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.

Powiązane akcje

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

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