Fraza: propozycje (`getKeywordsPropositions`)

POST/api/serp_analysis/reports/keyword/getKeywordsPropositions

Zwraca propozycje fraz do rozbudowy treści wokół badanego tematu — frazy powiązane z metrykami (wyszukiwania, CPC, trend, warianty pisowni variations, typy snippetów). Przydatne przy planowaniu contentu pod pełne pokrycie tematyczne.

Podgląd · 6 z 8 kolumn

Fraza	Wyszukiwania	CPC	CPC min	CPC max	Liczba słów
pies	110 000	0,92	0,08	1,76	1
pies sznaucer miniaturowy	60 500	0,13	0,06	0,19	3
berneński pies pasterski	60 500	0,1	0,08	0,13	3

task_id 1579873 „pies”, z filtrem na frazy zawierające „pies”. Wiersze zawierają też trend_1..12, trends[], variations[] i obiekt statistics (w JSON).

Obsługuje filtering (jak w Bazie słów). variations to warianty pisowni frazy. Wymaga task_id gotowego zadania.

Żądanie

POST /api/serp_analysis/reports/keyword/getKeywordsPropositions

żądanie.jsonc


{
  "task_id": null,
  "limit": 10,
  "page": 1,
  // bez filtra ranking schodzi na najpopularniejsze frazy z całego zbioru propozycji,
  // niekoniecznie związane z tematem — filtr trzyma listę przy badanej frazie
  "filtering": [{ "filters": [{ "key": "keywords", "items": [{ "value": "pies", "match": "contain" }] }], "conjunction": "and" }]
}

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`
`filtering`	`Record<string, unknown>[]` Opcjonalne filtry (jak w Bazie słów).

Odpowiedź

Name	Type	Default
`success`	`boolean`
`data`	`{ added: string; keyword: string; searches: number; cpc: number; cpc_min: number \| null; cpc_max: number \| null; words_count: number; kid: string; variations: string[]; variations_number: number; snippets: string[]; trends: 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

keyword/getRelatedKeywords — frazy powiązane.
keyword/getQuestions — pytania powiązane.

Fraza: propozycje (getKeywordsPropositions)