---
title: "Baza słów kluczowych: części mowy (`getSpeechParts`)"
source: https://docs.senuto.com/modules/keywords_analysis/ka-keywords-getSpeechParts
api: POST /api/keywords_analysis/reports/keywords/getSpeechParts
---

# Baza słów kluczowych: części mowy (`getSpeechParts`)

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

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "count": 4016,
      "name": "but"
    },
    {
      "count": 1444,
      "name": "Nike"
    },
    {
      "count": 598,
      "name": "adidas"
    },
    {
      "count": 575,
      "name": "Max"
    },
    {
      "count": 468,
      "name": "sklep"
    }
  ]
}
```

Zwraca rozkład wybranej **części mowy** w zbiorze fraz pasujących do zapytania — dla każdego słowa (rzeczownika/przymiotnika/orzeczenia) liczbę wystąpień. Część mowy wybierasz parametrem `type`. Zbiór fraz możesz zawęzić opcjonalnym `filtering` (jak w [`keywords/getKeywords`](/modules/keywords_analysis/ka-keywords-getKeywords#filtrowanie-i-sortowanie)) — np. tylko frazy o `searches ≥ 100 000`.

| Słowo | Liczba wystąpień |
| --- | --- |
| but | 4016 |
| Nike | 1444 |
| adidas | 598 |
| Max | 575 |
| sklep | 468 |

_parameters keyword „buty do biegania”, match_mode wide, country_id 1, type „subjects”. Wszystkie pola wiersza._

> **Ostrzeżenie:**
> Parametr **`type`** jest wymagany i walidowany — dozwolone: `subjects` (rzeczowniki), `adjectives` (przymiotniki), `predicates` (orzeczenia). Inna wartość → `418` (`invalid_data`). Uruchomienie zużywa jednostkę `keywords_analysis_queries_per_day`.

---

## Żądanie

`POST` `/api/keywords_analysis/reports/keywords/getSpeechParts`

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

### Parametry

```ts
type KeywordsGetSpeechPartsRequest = {
/** **Wymagane**. Grupy zapytania — jak w keywords/getKeywords. */
parameters: Array<{ data_fetch_mode: 'keyword' | 'url' | 'domain' | 'catalog'; value: string[] }>;
/** **Wymagane**. Tryb dopasowania: `wide` | `medium` | `narrow`. */
match_mode: 'wide' | 'medium' | 'narrow';
/** **Wymagane**. Część mowy: `subjects` | `adjectives` | `predicates`. */
type: 'subjects' | 'adjectives' | 'predicates';
/** ID kraju (bazy słów). */
country_id?: number;
/**
 * Filtrowanie zbioru fraz *przed* zliczeniem części mowy. Składnia i dozwolone klucze
 * jak w keywords/getKeywords (nieznany `key` → `418` `invalid_filtering`). Sortowania (`order`) brak.
 */
filtering?: Array<{
  filters: Array<{ key: string; match?: 'gt' | 'gte' | 'lt' | 'lte' | 'eq'; value: string | number | Array<string | number>; complement?: boolean }>;
  conjunction?: 'and' | 'or';
}>;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
}
export default KeywordsGetSpeechPartsRequest
```

## Odpowiedź

`data` to lista słów z liczbą wystąpień.

```ts
type KeywordsGetSpeechPartsResponse = {
success: boolean;
data: Array<{ name: string; count: number }>;
}
export default KeywordsGetSpeechPartsResponse
```

## Błędy

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

## Powiązane akcje

- `keywords/getTagsCloud` — najczęstsze n-gramy w zbiorze fraz.
- `keywords/getKeywords` — główna wyszukiwarka fraz.