Baza słów kluczowych: trendy (`getTrending`)

POST/api/keywords_analysis/reports/keywords/getTrending

Zwraca frazy trendujące (o rosnącej liczbie wyszukiwań) w wybranym kraju i okresie. W odróżnieniu od pozostałych raportów tego modułu nie przyjmuje frazy wejściowej — filtruje po kraju i zakresie dat.

Zbiór trendujących fraz jest kuratorowany, więc dla części kont i krajów endpoint zwraca 200 z pustą listą (data: []) — także dla różnych zakresów dat. Kształt wiersza poniżej jest orientacyjny. Uruchomienie zużywa jednostkę keywords_analysis_queries_per_day.

Żądanie

POST /api/keywords_analysis/reports/keywords/getTrending

żądanie.jsonc


{
  "country_id": 1,
  "date_min": "2026-06-01",
  "date_max": "2026-06-29",
  "limit": 20,
  "page": 1,
  "order": { "prop": "searches", "dir": "desc" },
  "filtering": []
}

Parametry

Name	Type	Default
`country_id`	`number` ID kraju (bazy słów), np. `1` (PL 1.0).
`date_min`	`string` Data początkowa okresu (RRRR-MM-DD).
`date_max`	`string` Data końcowa okresu (RRRR-MM-DD).
`limit`	`number` Liczba wierszy na stronę.	`10`
`page`	`number` Numer strony.	`1`
`order`	`{ prop: string; dir: "asc" \| "desc"; }` Sortowanie `{ prop, dir }`.
`filtering`	`unknown[]` Grupy filtrów.

Odpowiedź

data to lista fraz trendujących (może być pusta), plus pagination. Kształt wiersza jest zbliżony do pozostałych raportów bazy: fraza plus metryki wyszukiwań i trendu.

Name	Type	Default
`success`	`boolean`
`data`	`unknown[]` Lista fraz trendujących; może być pusta
`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

keywords/getKeywords — główna wyszukiwarka fraz.

Baza słów kluczowych: trendy (getTrending)