---
title: "Statystyki fraz: wiersze (`getKeywords`)"
source: https://docs.senuto.com/modules/keywords_analysis/ka-statistics-getKeywords
api: POST /api/keywords_analysis/tools/statistics/getKeywords
---

# Statystyki fraz: wiersze (`getKeywords`)

**`POST /api/keywords_analysis/tools/statistics/getKeywords`**

Przykładowe żądanie:

```json
{
  "public_id": null,
  "limit": 10
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "keyword": "sukienka",
      "searches": 368000,
      "cpc": 0.15,
      "words_count": 1,
      "trends": [
        368000,
        301000,
        368000,
        450000,
        550000,
        368000,
        301000,
        301000,
        246000,
        246000,
        301000,
        368000
      ],
      "serp_params": [
        "adwords",
        "image_thumbs",
        "map",
        "news",
        "pla",
        "top_bar",
        "video_thumbs"
      ]
    }
  ],
  "pagination": {
    "page_count": 1,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": 8,
    "limit": 10
  }
}
```

Zwraca **pełne wiersze statystyk** dla fraz z [`statistics/create`](/modules/keywords_analysis/ka-statistics-create) (odczyt z cache po `public_id`): liczbę wyszukiwań, CPC, liczbę słów, 12-miesięczny trend oraz typy snippetów SERP (`serp_params`). Bez konsumpcji limitu.

| Fraza | Wyszukiwania | CPC | Liczba słów |
| --- | --- | --- | --- |
| sukienka | 368000 | 0.15 | 1 |

_frazy buty/sukienka/kurtka, PL. Wiersze zawierają też trend_1..12, trends[] i obiekt statistics (w JSON)._

> **Informacja:**
> Obsługuje `filtering` oraz `order`. `serp_params` to typy elementów SERP obecne dla frazy. Odczyt z cache — nie konsumuje limitu.

---

## Żądanie

`POST` `/api/keywords_analysis/tools/statistics/getKeywords`

```jsonc filename="żądanie.jsonc"
{ "public_id": null, "limit": 10, "page": 1 }
```

### Parametry

```ts
type KaStatisticsGetKeywordsRequest = {
/** **Wymagane**. Klucz z statistics/create. */
public_id: string;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
filtering?: Record<string, unknown>[];
order?: Record<string, unknown>[];
}
export default KaStatisticsGetKeywordsRequest
```

## Odpowiedź

```ts
type KaStatisticsGetKeywordsResponse = {
success: boolean;
data: Array<{
  keyword: string;
  searches: number;
  cpc: number;
  words_count: number;
  /** 12-miesięczny trend liczby wyszukiwań. */
  trends: number[];
  /** Typy snippetów SERP obecne dla frazy. */
  serp_params: string[];
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default KaStatisticsGetKeywordsResponse
```

## Błędy

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

## Powiązane akcje

- [`statistics/create`](/modules/keywords_analysis/ka-statistics-create) — utworzenie wyniku.