---
title: "Baza słów kluczowych: trendy (`getTrending`)"
source: https://docs.senuto.com/modules/keywords_analysis/ka-keywords-getTrending
api: POST /api/keywords_analysis/reports/keywords/getTrending
---

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

**`POST /api/keywords_analysis/reports/keywords/getTrending`**

Przykładowe żądanie:

```json
{
  "country_id": 1,
  "date_min": "2026-06-01",
  "date_max": "2026-06-29",
  "limit": 20
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [],
  "pagination": {
    "page_count": 0,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": 0,
    "limit": 20
  }
}
```

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.

> **Ostrzeżenie:**
> 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`

```jsonc filename="żą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

```ts
type KeywordsGetTrendingRequest = {
/** ID kraju (bazy słów), np. `1` (PL 1.0). */
country_id?: number;
/** Data początkowa okresu (RRRR-MM-DD). */
date_min?: string;
/** Data końcowa okresu (RRRR-MM-DD). */
date_max?: string;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
/** Sortowanie `{ prop, dir }`. */
order?: { prop: string; dir: 'asc' | 'desc' };
/** Grupy filtrów. */
filtering?: unknown[];
}
export default KeywordsGetTrendingRequest
```

## 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.

```ts
type KeywordsGetTrendingResponse = {
success: boolean;
/** Lista fraz trendujących; może być pusta */
data: unknown[];
pagination: { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number };
}
export default KeywordsGetTrendingResponse
```

## Błędy

Błędy tego endpointu przychodzą we [wspólnej kopercie ze statusem `418`](/types/errors).

## Powiązane akcje

- `keywords/getKeywords` — główna wyszukiwarka fraz.