---
title: "Fraza: statystyki (`getStatistics`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-keyword-getStatistics
api: POST /api/serp_analysis/reports/keyword/getStatistics
---

# Fraza: statystyki (`getStatistics`)

**`POST /api/serp_analysis/reports/keyword/getStatistics`**

Przykładowe żądanie:

```json
{
  "task_id": null
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": {
    "trends": [
      90500,
      90500,
      90500,
      110000,
      135000,
      135000,
      135000,
      135000,
      110000,
      110000,
      110000,
      110000
    ],
    "rank_value": 36044.92,
    "cpc": 0.92,
    "params": [
      "image_thumbs",
      "video_thumbs",
      "wiki_right"
    ],
    "searches": 110000
  }
}
```

Zwraca **podstawowe statystyki frazy** zadania: średnią miesięczną liczbę wyszukiwań (`searches`), 12-miesięczny trend (`trends`), koszt kliknięcia (`cpc`), wskaźnik `rank_value` oraz obecne w SERP typy snippetów (`params`).

**Trend wyszukiwań frazy „pies” (12 miesięcy)**

| Wartość | wyszukiwań/mies. |
| --- | --- |
| mies. 1 | 90500 |
| mies. 2 | 90500 |
| mies. 3 | 90500 |
| mies. 4 | 110000 |
| mies. 5 | 135000 |
| mies. 6 | 135000 |
| mies. 7 | 135000 |
| mies. 8 | 135000 |
| mies. 9 | 110000 |
| mies. 10 | 110000 |
| mies. 11 | 110000 |
| mies. 12 | 110000 |

_task_id 1579873. Wartości z data.trends._

> **Informacja:**
> `params` to lista typów elementów SERP obecnych dla frazy (np. `image_thumbs` = miniatury grafik, `wiki_right` = panel wiedzy). Wymaga `task_id` **gotowego** zadania (`progress.has_serp_data`).

---

## Żądanie

`POST` `/api/serp_analysis/reports/keyword/getStatistics`

```jsonc filename="żądanie.jsonc"
{ "task_id": null }
```

### Parametry

```ts
type SerpKeywordStatisticsRequest = {
/** **Wymagane**. ID gotowego zadania SERP. Realny `task_id` pobierzesz z `POST /api/tasks/management/serp_analysis/list` albo z odpowiedzi `create`. */
task_id: number;
}
export default SerpKeywordStatisticsRequest
```

## Odpowiedź

```ts
type SerpKeywordStatisticsResponse = {
success: boolean;
data: {
  /** 12-miesięczny trend liczby wyszukiwań. */
  trends: number[];
  rank_value: number;
  cpc: number;
  /** Typy snippetów SERP obecne dla frazy. */
  params: string[];
  searches: number;
};
}
export default SerpKeywordStatisticsResponse
```

## Błędy

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

## Powiązane akcje

- [`keyword/getCompetitorsNumber`](/modules/serp_analysis/serp-keyword-getCompetitorsNumber) — liczba konkurentów w SERP.
- [`keyword/getRelatedKeywords`](/modules/serp_analysis/serp-keyword-getRelatedKeywords) — frazy powiązane.