Baza słów kluczowych: części mowy (`getSpeechParts`)

POST/api/keywords_analysis/reports/keywords/getSpeechParts

Zwraca rozkład wybranej części mowy w zbiorze fraz pasujących do zapytania — dla każdego słowa (rzeczownika/przymiotnika/orzeczenia) liczbę wystąpień. Część mowy wybierasz parametrem type. Zbiór fraz możesz zawęzić opcjonalnym filtering (jak w keywords/getKeywords) — np. tylko frazy o searches ≥ 100 000.

Słowo	Liczba wystąpień
but	4016
Nike	1444
adidas	598
Max	575
sklep	468

parameters keyword „buty do biegania”, match_mode wide, country_id 1, type „subjects”. Wszystkie pola wiersza.

Parametr type jest wymagany i walidowany — dozwolone: subjects (rzeczowniki), adjectives (przymiotniki), predicates (orzeczenia). Inna wartość → 418 (invalid_data). Uruchomienie zużywa jednostkę keywords_analysis_queries_per_day.

Żądanie

POST /api/keywords_analysis/reports/keywords/getSpeechParts

żądanie.jsonc


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

Parametry

Name	Type	Default
`parameters`	`{ data_fetch_mode: "keyword" \| "url" \| "domain" \| "catalog"; value: string[]; }[]` Wymagane. Grupy zapytania — jak w keywords/getKeywords.
`match_mode`	`"wide" \| "medium" \| "narrow"` Wymagane. Tryb dopasowania: `wide` \| `medium` \| `narrow`.
`type`	`"subjects" \| "adjectives" \| "predicates"` Wymagane. Część mowy: `subjects` \| `adjectives` \| `predicates`.
`country_id`	`number` ID kraju (bazy słów).
`filtering`	`{ filters: { key: string; match?: "gt" \| "gte" \| "lt" \| "lte" \| "eq"; value: string \| number \| (string \| number)[]; complement?: boolean; }[]; conjunction?: "and" \| "or"; }[]` Filtrowanie zbioru fraz przed zliczeniem części mowy. Składnia i dozwolone klucze jak w keywords/getKeywords (nieznany `key` → `418` `invalid_filtering`). Sortowania (`order`) brak.
`limit`	`number` Liczba wierszy na stronę.	`10`
`page`	`number` Numer strony.	`1`

Odpowiedź

data to lista słów z liczbą wystąpień.

Name	Type	Default
`success`	`boolean`
`data`	`{ name: string; count: number; }[]`

Błędy

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

Powiązane akcje

keywords/getTagsCloud — najczęstsze n-gramy w zbiorze fraz.
keywords/getKeywords — główna wyszukiwarka fraz.

Baza słów kluczowych: części mowy (getSpeechParts)