---
title: "Baza słów kluczowych: narzędzia · sugestie fraz (`suggest`)"
source: https://docs.senuto.com/modules/keywords_analysis/ka-keywords-suggester-suggest
api: POST /api/keywords_analysis/tools/keywords_suggester/suggest
---

# Baza słów kluczowych: narzędzia · sugestie fraz (`suggest`)

**`POST /api/keywords_analysis/tools/keywords_suggester/suggest`**

Przykładowe żądanie:

```json
{
  "country_id": 1,
  "keywords": [
    "buty do biegania"
  ],
  "mode": "lr",
  "iterations": 2,
  "limit": 10
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "parent_keyword": "buty do biegania",
      "suggested_keyword": "buty do biegania salomon",
      "first_letter": "b",
      "keywords_number": 3
    }
  ],
  "pagination": {
    "page_count": 260,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 2597,
    "limit": 10
  }
}
```

Generuje **sugestie fraz** przez rozwijanie słów wejściowych (`keywords`) — technika podpowiedzi/autouzupełniania (dopisywanie słów przed/po frazie). Dla każdej sugestii zwraca frazę źródłową (`parent_keyword`), zaproponowaną frazę (`suggested_keyword`), pierwszą literę i liczbę słów.

| Sugerowana fraza | Fraza źródłowa | Pierwsza litera | Liczba słów |
| --- | --- | --- | --- |
| buty do biegania salomon | buty do biegania | b | 3 |
| buty do biegania skechers | buty do biegania | b | 3 |
| buty do biegania saucony | buty do biegania | b | 3 |
| buty do biegania salomon damskie | buty do biegania | b | 4 |

_country_id 1, keywords „buty do biegania”, mode „lr”, iterations 2. Wszystkie pola wiersza._

> **Ostrzeżenie:**
> To **narzędzie** (`tools/*`) — zużywa jednostkę dziennego limitu narzędzi Bazy słów (`keywords_analysis_suggester` / `tools_daily_limit`). Patrz [Limity zapytań](/rate-limits).

---

## Żądanie

`POST` `/api/keywords_analysis/tools/keywords_suggester/suggest`

```jsonc filename="żądanie.jsonc"
{
  "country_id": 1,
  "keywords": ["buty do biegania"],
  "mode": "lr",
  "iterations": 2,
  "limit": 10
}
```

### Parametry

```ts
type KeywordsSuggesterRequest = {
/** **Wymagane**. ID kraju (bazy słów). */
country_id: number;
/** **Wymagane**. Frazy wejściowe do rozwinięcia. */
keywords: string[];
/** Tryb rozwijania (kierunek dopisywania słów). @default 'lr' */
mode?: string;
/** Głębokość rozwinięcia (liczba iteracji). @default 2 */
iterations?: number;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
/** Sortowanie `{ prop, dir }`. */
order?: { prop: string; dir: 'asc' | 'desc' };
}
export default KeywordsSuggesterRequest
```

## Odpowiedź

```ts
type KeywordsSuggesterResponse = {
success: boolean;
data: Array<{
  /** Fraza źródłowa, z której powstała sugestia */
  parent_keyword: string;
  /** Zaproponowana fraza */
  suggested_keyword: string;
  first_letter: string;
  /** Liczba słów w sugestii */
  keywords_number: number;
}>;
pagination: { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number };
}
export default KeywordsSuggesterResponse
```

## Błędy

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

## Powiązane akcje

- `keywords/getKeywords` — pełna wyszukiwarka bazy z metrykami.
- `keywords/getRelated` — frazy powiązane semantycznie.