Fraza: liderzy tematu (`getTopicLeaders`)

POST/api/serp_analysis/reports/keyword/getTopicLeaders

Zwraca liderów tematu — adresy URL najczęściej pojawiające się w TOP dla fraz z badanego tematu (occurrences = liczba fraz, dla których URL rankuje). Wskazuje strony o najsilniejszej pozycji tematycznej.

URL	Liczba wystąpień
allegro.pl/kategoria/zywe-zwierzeta-psy-5344	2752
gratka.pl/zwierzeta/psy	1038
psy.pl/imiona-dla-psa/	922
medme.pl/artykuly/badanie-psa-normy-wolny-calkowity,67743.html	834
polki.pl/dom/zwierzeta,imiona-dla-psow,10410993,artykul.html	832

task_id 1579873 „pies”.

Żądanie

POST /api/serp_analysis/reports/keyword/getTopicLeaders

żądanie.jsonc


{ "task_id": null, "limit": 10, "page": 1 }

Parametry

Name	Type	Default
`task_id`	`number` Wymagane. ID gotowego zadania SERP.
`filtering`	`{ filters: { key: string; match?: "gt" \| "gte" \| "lt" \| "lte" \| "eq"; value: string \| number \| (string \| number)[]; complement?: boolean; }[]; conjunction?: "and" \| "or"; }[]` Filtrowanie zbioru fraz tematu. Ten sam mechanizm co w keywords/getKeywords (komponent dziedziczy rejestr filtrów Bazy słów). Nieznany `key` → `418` `invalid_filtering`. Dozwolone klucze m.in.: `searches`, `cpc`, `words_count`, `keywords`, `snippets`, `trends_peaks`, `added`. Operatory liczbowe: `gt` \| `gte` \| `lt` \| `lte` \| `eq`.
`limit`	`number` Liczba wierszy na stronę.	`10`
`page`	`number` Numer strony.	`1`

Odpowiedź

Name	Type	Default
`success`	`boolean`
`data`	`{ url: string; occurrences: 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

urls/getList — pełna lista wyników SERP badanej frazy.
keyword/getGroups — grupy tematyczne.

Fraza: liderzy tematu (getTopicLeaders)