Fraza: powiązane (`getRelatedKeywords`)

POST/api/serp_analysis/reports/keyword/getRelatedKeywords

Zwraca frazy powiązane semantycznie z badaną frazą — na podstawie wspólnych wyników w SERP (common_factor). Dla każdej frazy: liczbę wyszukiwań, CPC (z zakresem cpc_min/cpc_max), liczbę słów, 12-miesięczny trend oraz typy snippetów (params).

Podgląd · 6 z 8 kolumn

Fraza	Wyszukiwania	Wsp. wspólny	Liczba słów	CPC	CPC min
pies	110 000	18	1	0,92	0,08
pies pies	590	6	2	0	0
piesie	50	5	1	0	—

task_id 1579873 „pies”. Wiersze zawierają też pola trend_1..12 oraz obiekt statistics (w JSON).

common_factor = liczba wspólnych adresów URL w TOP dla obu fraz (im wyższy, tym silniejsze powiązanie). Wymaga task_id gotowego zadania.

Żądanie

POST /api/serp_analysis/reports/keyword/getRelatedKeywords

żądanie.jsonc


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

Parametry

Name	Type	Default
`task_id`	`number` Wymagane. ID gotowego zadania SERP. Realny `task_id` pobierzesz z `POST /api/tasks/management/serp_analysis/list` albo z odpowiedzi `create`.
`limit`	`number` Liczba wierszy na stronę.	`10`
`page`	`number` Numer strony.	`1`

Odpowiedź

Name	Type	Default
`success`	`boolean`
`data`	`{ [trend: string]: unknown; id: string; keyword: string; searches: number; common_factor: number; parent_keyword: string; cpc: number; words_count: number; cpc_min: number \| null; cpc_max: number \| null; params: string[]; }[]`
`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

keyword/getKeywordsPropositions — propozycje fraz.
keyword/getQuestions — pytania powiązane.

Fraza: powiązane (getRelatedKeywords)