---
title: "Baza słów kluczowych: powiązane (`getRelated`)"
source: https://docs.senuto.com/modules/keywords_analysis/ka-keywords-getRelated
api: POST /api/keywords_analysis/reports/keywords/getRelated
---

# Baza słów kluczowych: powiązane (`getRelated`)

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

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "id": "68944706",
      "keyword": "buty do biegania",
      "searches": 60500,
      "common_factor": 18,
      "parent_keyword": "buty do biegania",
      "cpc": 0.8,
      "cpc_min": 0.38,
      "cpc_max": 1.21,
      "words_count": 3,
      "params": [
        "adwords",
        "image_thumbs",
        "map",
        "news",
        "pla",
        "top_bar",
        "yellow_pages"
      ]
    }
  ],
  "pagination": {
    "page_count": 144,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 288,
    "limit": 2
  }
}
```

Zwraca frazy **powiązane semantycznie** z zapytaniem — wraz z metrykami (wyszukiwania, CPC, liczba słów, trend), cechami SERP (`params`) oraz `common_factor` (siła powiązania) i `parent_keyword` (fraza źródłowa). Request identyczny jak w [`keywords/getKeywords`](/modules/keywords_analysis/ka-keywords-getKeywords).

| Fraza | ID | Wyszukiwania/mies. | Współczynnik wspólny | Fraza źródłowa | CPC | CPC min | CPC max | Liczba słów | Cechy SERP |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| buty do biegania | 68944706 | 60500 | 18 | buty do biegania | 0.8 | 0.38 | 1.21 | 3 | ["adwords","image_thumbs","map","news","pla","top_bar","yellow_pages"] |

_parameters keyword „buty do biegania”, match_mode wide, country_id 1. Pominięto zdublowane trend_1..12 (= trend) i statistics{}._

> **Ostrzeżenie:**
> Uruchomienie zużywa jednostkę `keywords_analysis_queries_per_day` — patrz [Limity zapytań](/rate-limits).

---

## Żądanie

`POST` `/api/keywords_analysis/reports/keywords/getRelated`

```jsonc filename="żądanie.jsonc"
{
  "parameters": [{ "data_fetch_mode": "keyword", "value": ["buty do biegania"] }],
  "match_mode": "wide",
  "country_id": 1,
  "limit": 10,
  "order": { "prop": "searches", "dir": "desc" },
  "filtering": []
}
```

### Parametry

Identyczne jak w [`keywords/getKeywords`](/modules/keywords_analysis/ka-keywords-getKeywords): `parameters[{ data_fetch_mode, value[] }]`, `match_mode` (`wide`/`medium`/`narrow`), `country_id`, `limit`/`page`. Dodatkowo `order` (`{ prop, dir }`) i `filtering`.

## Odpowiedź

```ts
type KeywordsGetRelatedResponse = {
success: boolean;
data: Array<{
  id: string;
  keyword: string;
  searches: number;
  /** Siła powiązania z frazą źródłową */
  common_factor: number;
  /** Fraza źródłowa (parent) */
  parent_keyword: string;
  cpc: number; cpc_min: number; cpc_max: number;
  words_count: number;
  /** Cechy SERP */
  params: string[];
  /** DUPLIKATY: trend_1..trend_12 oraz `statistics{}` */
  trend_1?: number;
  statistics?: unknown;
}>;
pagination: { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number };
}
export default KeywordsGetRelatedResponse
```

## Błędy

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

## Powiązane akcje

- `keywords/getKeywords` — główna wyszukiwarka.
- `keywords/getQuestions` — frazy pytające.