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

# Baza słów kluczowych: statystyki zbioru (`getResultsStatistics`)

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

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": {
    "searches": {
      "min": -1,
      "max": 135000,
      "sum": 3567428,
      "avg": 283.71
    },
    "cpc": {
      "min": 0,
      "max": 27.15,
      "sum": 4448.15,
      "avg": 0.35
    },
    "keywords": {
      "count": 12282
    },
    "trends": {
      "min": {
        "month": 12
      },
      "max": {
        "month": 3
      }
    }
  }
}
```

Zwraca **zagregowane statystyki** dla całego zbioru fraz pasujących do zapytania (bez listy fraz): zakres i sumę/średnią liczby wyszukiwań oraz CPC, całkowitą liczbę fraz i miesiące skrajne trendu. Przydatne jako podsumowanie nad wynikami wyszukiwarki.

> **Ostrzeżenie:**
> Uruchomienie zużywa jednostkę `keywords_analysis_queries_per_day` — patrz [Limity zapytań](/rate-limits).

---

## Żądanie

`POST` `/api/keywords_analysis/reports/keywords/getResultsStatistics`

```jsonc filename="żądanie.jsonc"
{
  "parameters": [{ "data_fetch_mode": "keyword", "value": ["buty do biegania"] }],
  "match_mode": "wide",
  "country_id": 1,
  "filtering": []
}
```

### Parametry

Jak w [`keywords/getKeywords`](/modules/keywords_analysis/ka-keywords-getKeywords): `parameters[{ data_fetch_mode, value[] }]`, `match_mode`, `country_id`, plus `filtering`. Endpoint zwraca podsumowanie, więc nie paginuje wyników.

## Odpowiedź

`data` to obiekt statystyk zbioru.

```ts
type KeywordsGetResultsStatisticsResponse = {
success: boolean;
data: {
  /** Statystyki liczby wyszukiwań w zbiorze */
  searches: { min: number; max: number; sum: number; avg: number };
  /** Statystyki CPC w zbiorze */
  cpc: { min: number; max: number; sum: number; avg: number };
  /** Łączna liczba fraz w zbiorze */
  keywords: { count: number };
  /** Miesiące skrajne trendu (1–12) */
  trends: { min: { month: number }; max: { month: number } };
};
}
export default KeywordsGetResultsStatisticsResponse
```

## Błędy

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

## Powiązane akcje

- `keywords/getKeywords` — lista fraz w zbiorze.
- `keywords/getDomainsList` — domeny rankujące w zbiorze.