---
title: "Fraza: powiązane (`getRelatedKeywords`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-keyword-getRelatedKeywords
api: POST /api/serp_analysis/reports/keyword/getRelatedKeywords
---

# Fraza: powiązane (`getRelatedKeywords`)

**`POST /api/serp_analysis/reports/keyword/getRelatedKeywords`**

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "id": "89893385",
      "keyword": "pies",
      "searches": 110000,
      "common_factor": 18,
      "parent_keyword": "pies",
      "cpc": 0.92,
      "words_count": 1,
      "cpc_min": 0.08,
      "cpc_max": 1.76,
      "params": [
        "image_thumbs",
        "video_thumbs",
        "wiki_right"
      ]
    }
  ],
  "pagination": {
    "page_count": 2,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 16,
    "limit": 10
  }
}
```

Zwraca **frazy powiązane** semantycznie z badaną frazą — na podstawie wspólnych wyników w SERP (`common_factor`). Dla każdej frazy: liczbę wyszukiwań, CPC (z zakresem `cpc_min`/`cpc_max`), liczbę słów, 12-miesięczny trend oraz typy snippetów (`params`).

| Fraza | Wyszukiwania | Wsp. wspólny | Liczba słów | CPC | CPC min | CPC max | Fraza źródłowa |
| --- | --- | --- | --- | --- | --- | --- | --- |
| pies | 110000 | 18 | 1 | 0.92 | 0.08 | 1.76 | pies |
| pies pies | 590 | 6 | 2 | 0 | 0 | 0 | pies |
| piesie | 50 | 5 | 1 | 0 |  |  | pies |

_task_id 1579873 „pies”. Wiersze zawierają też pola trend_1..12 oraz obiekt statistics (w JSON)._

> **Informacja:**
> `common_factor` = liczba wspólnych adresów URL w TOP dla obu fraz (im wyższy, tym silniejsze powiązanie). Wymaga `task_id` gotowego zadania.

---

## Żądanie

`POST` `/api/serp_analysis/reports/keyword/getRelatedKeywords`

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

### Parametry

```ts
type SerpRelatedKeywordsRequest = {
/** **Wymagane**. ID gotowego zadania SERP. Realny `task_id` pobierzesz z `POST /api/tasks/management/serp_analysis/list` albo z odpowiedzi `create`. */
task_id: number;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
}
export default SerpRelatedKeywordsRequest
```

## Odpowiedź

```ts
type SerpRelatedKeywordsResponse = {
success: boolean;
data: Array<{
  id: string;
  keyword: string;
  searches: number;
  /** Liczba wspólnych URL-i w TOP z frazą źródłową. */
  common_factor: number;
  parent_keyword: string;
  cpc: number;
  words_count: number;
  cpc_min: number | null;
  cpc_max: number | null;
  params: string[];
  /** trend_1..trend_12 — miesięczne wartości trendu. */
  [trend: string]: unknown;
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default SerpRelatedKeywordsResponse
```

## Błędy

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

## Powiązane akcje

- [`keyword/getKeywordsPropositions`](/modules/serp_analysis/serp-keyword-getKeywordsPropositions) — propozycje fraz.
- [`keyword/getQuestions`](/modules/serp_analysis/serp-keyword-getQuestions) — pytania powiązane.