Szczegóły frazy: frazy powiązane (getRelatedKeywords)
/api/keywords_analysis/reports/keyword_details/getRelatedKeywordsZwraca frazy powiązane z podaną — takie, które dzielą z nią adresy URL w TOP wyników. Siłę powiązania opisuje common_factor: liczba wspólnych URL-i.
Raport odpytujesz wprost frazą i krajem — bez wcześniejszego tworzenia zadania w Analizie SERP. Jedno żądanie zastępuje ścieżkę „utwórz zadanie → sprawdź status → pobierz wynik” i nie zużywa limitu zadań.
Dla frazy hamak w Polsce raport zwrócił 461 wierszy.
Żądanie
POST /api/keywords_analysis/reports/keyword_details/getRelatedKeywords
Nagłówki: Authorization: Bearer <token>, Content-Type: application/json.
Parametry przekazuje się w treści żądania.
Żądanie
{
"keyword": "hamak",
"country_id": 1,
"limit": 10
}Parametry
| Name | Type | Default |
|---|---|---|
keyword | stringWymagane. Fraza kluczowa, dla której pobierany jest raport. Pusty string zwraca | |
country_id | numberWymagane. Identyfikator kraju; musi istnieć w słowniku krajów — nieznana wartość zwraca
| 1 |
filtering | Record<string, unknown>[]Ignorowane przez tę akcję. Sprawdzone na produkcji: poprawny filtr nie zmienia liczby
wyników, a nieznany | |
page | numberNumer strony wyników. | |
limit | numberLiczba wierszy na stronę. |
Zarówno keyword, jak i country_id są wymagane. Nieznane country_id zwraca 418 z Unknown country_id, a wartość 200 jest mapowana na 1 — dla Polski trafisz więc do bazy 1.0, nie 2.0.
Parametr filtering nie działa na tej akcji. Sprawdzone na produkcji: poprawny filtr nie zmienia liczby wyników, a nieznany klucz zwraca 200 zamiast 418. Zawężaj wyniki po swojej stronie.
Ta akcja nie zwraca tablicy trends — trend jest tylko w polach trend_1 … trend_12 oraz w statistics.trends.history. Cechy SERP nazywają się tu params, a nie snippets jak w pozostałych raportach rodziny.
Odpowiedź
Przykład poniżej to rzeczywista odpowiedź produkcyjna dla frazy hamak (country_id: 1),
skrócona do jednego wiersza.
{
"success": true,
"data": [
{
"id": "52043408",
"keyword": "hamak",
"searches": 22200,
"common_factor": 18,
"parent_keyword": "hamak",
"cpc": 0.91,
"cpc_min": 0.23,
"cpc_max": 1.6,
"words_count": 1,
"trend_1": 40500,
"trend_2": 27100,
"trend_3": 12100,
"trend_4": 6600,
"trend_5": 8100,
"trend_6": 8100,
"trend_7": 9900,
"trend_8": 9900,
"trend_9": 22200,
"trend_10": 27100,
"trend_11": 49500,
"trend_12": 40500,
"params": [
"image_thumbs",
"map",
"pla",
"top_bar",
"video_thumbs"
],
"statistics": {
"snippets": {
"current": [
"image_thumbs",
"map",
"pla",
"top_bar",
"video_thumbs"
]
},
"searches": {
"current": 22200
},
"cpc": {
"current": 0.91
},
"cpc_min": {
"current": 0.23
},
"cpc_max": {
"current": 1.6
},
"trends": {
"history": [
40500,
27100,
12100,
6600,
8100,
8100,
9900,
9900,
22200,
27100,
49500,
40500
]
}
}
}
],
"pagination": {
"page_count": 231,
"current_page": 1,
"has_next_page": true,
"has_prev_page": false,
"count": 461,
"limit": 2
}
}Struktura odpowiedzi
| Name | Type | Default |
|---|---|---|
success | boolean | |
data | { id: string; keyword: string; parent_keyword: string; searches: number; common_factor: number; cpc: number; cpc_min: number | null; cpc_max: number | null; words_count: number; params: string[]; ... 12 more ...; statistics: { ...; }; }[] | |
pagination | { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number; }Paginacja liczona z całego zbioru — |
Błędy
Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.
Powiązane akcje
Wszystkie poniższe raporty przyjmują tę samą parę keyword + country_id:
getStatistics— zbiorcze statystyki frazy.getQuestions— pytania o frazę.getKeywordsPropositions— propozycje fraz.getTopicLeaders— liderzy tematu.getGroups— grupy frazy.getCompetitorsNumber— liczba konkurentów.