Baza słów kluczowych: chmura tagów (`getTagsCloud`)

POST/api/keywords_analysis/reports/keywords/getTagsCloud

Zwraca chmurę tagów: najczęstsze n-gramy (składowe frazy) występujące w zbiorze słów kluczowych pasujących do zapytania, wraz z liczbą wystąpień. Przydatne do szybkiego zobaczenia dominujących motywów/intencji w temacie.

Najczęstsze n-gramy (liczba wystąpień)

parameters keyword „buty do biegania”, match_mode wide, country_id 1. `data` to mapa n-gram → liczba; poniżej top wyników.

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

Żądanie

POST /api/keywords_analysis/reports/keywords/getTagsCloud

żądanie.jsonc


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

Parametry

Jak w keywords/getKeywords: parameters[{ data_fetch_mode, value[] }], match_mode, country_id. Parametr limit określa liczbę zwracanych tagów.

W przeciwieństwie do pozostałych raportów Bazy słów kluczowych ten endpoint nie obsługuje filtering ani order. Pole filtering jest wprawdzie przyjmowane bez błędu, ale ignorowane — nie zawęża wyniku, a nieznany key nie zwraca 418 (potwierdzone na prod: identyczny wynik z filtrem i bez). Aby operować na przefiltrowanym zbiorze fraz, użyj keywords/getKeywords lub keywords/getSpeechParts.

Odpowiedź

data to mapa n-gram → liczba wystąpień (klucze są zmienne — to nie lista wierszy).

Name	Type	Default
`success`	`boolean`
`data`	`Record<string, number>` Mapa: n-gram (klucz) -> liczba wystąpień

Błędy

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

Powiązane akcje

keywords/getKeywords — główna wyszukiwarka fraz.
keywords/getSpeechParts — rozkład części mowy w zbiorze fraz.

Baza słów kluczowych: chmura tagów (getTagsCloud)