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

# Statystyki fraz: utworzenie (`create`)

> **Błąd:**
> **Endpoint mutujący.** Zużywa jednostkę dziennego limitu narzędzi (`tools_daily_limit`) oraz limit `keywords_analysis_tool_keywords_statistics` (zależny od liczby fraz). Wynik zapisywany jest w cache pod `public_id` — [`getKeywords`](/modules/keywords_analysis/ka-statistics-getKeywords) odczytuje go **bez** ponownej konsumpcji.

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

Przykładowe żądanie:

```json
{
  "keywords": [
    "buty",
    "buty damskie",
    "sukienka",
    "kurtka zimowa"
  ],
  "country_id": 1
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": {
    "has_data": true,
    "statistics": {
      "all_keywords": 8,
      "fetched_keywords": 8
    },
    "public_id": "b595c23e958c78a715474c35e80d3a18"
  }
}
```

Pobiera **statystyki dla przesłanej listy fraz** (własnych): liczbę wyszukiwań, CPC, 12-miesięczny trend i typy snippetów SERP. Zwraca `public_id`, pod którym pełne wiersze są dostępne w cache — pobierzesz je przez [`getKeywords`](/modules/keywords_analysis/ka-statistics-getKeywords), bez ponownej konsumpcji limitu.

---

## Żądanie

`POST` `/api/keywords_analysis/tools/statistics/create`

```jsonc filename="żądanie.jsonc"
{ "keywords": ["buty", "sukienka"], "country_id": 1 }
```

### Parametry

```ts
type KaStatisticsCreateRequest = {
/** **Wymagane**. Lista fraz. */
keywords: string[];
/** **Wymagane**. ID kraju (1 = Polska). */
country_id: number;
}
export default KaStatisticsCreateRequest
```

## Odpowiedź

```ts
type KaStatisticsCreateResponse = {
success: boolean;
data: {
  has_data: boolean;
  statistics: { all_keywords: number; fetched_keywords: number };
  /** Klucz do odczytu wierszy przez getKeywords. */
  public_id: string;
};
}
export default KaStatisticsCreateResponse
```

## Błędy

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

## Powiązane akcje

- [`statistics/checkData`](/modules/keywords_analysis/ka-statistics-checkData) — sprawdzenie gotowości wyniku.
- [`statistics/getKeywords`](/modules/keywords_analysis/ka-statistics-getKeywords) — pobranie wierszy fraz.
- [Limity zapytań](/rate-limits) — `tools_daily_limit`.