---
title: "Kanibalizacja: frazy (`getKeywords`)"
source: https://docs.senuto.com/modules/rank_tracker/rt-cannibalization-getKeywords
api: POST /api/rank_tracker/tools/cannibalization/getKeywords
---

# Kanibalizacja: frazy (`getKeywords`)

**`POST /api/rank_tracker/tools/cannibalization/getKeywords`**

Przykładowe żądanie:

```json
{
  "project_id": null,
  "date_min": "2026-06-20",
  "date_max": "2026-06-29",
  "limit": 10
}
```

Przykładowe żądanie (rozszerzone):

```json
{
  "project_id": null,
  "date_min": "2026-06-20",
  "date_max": "2026-06-29",
  "limit": 10,
  "page": 1,
  "order": {
    "prop": "searches",
    "dir": "desc"
  },
  "filtering": []
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "keyword": "generator słów kluczowych",
      "searches": "320",
      "cpc": 6.4,
      "snippets": [
        "ai_overview",
        "people_also_ask",
        "related_searches"
      ],
      "unique_urls_count": 2,
      "urls": [
        "https://www.senuto.com/pl/blog/planer-slow-kluczowych/",
        "https://www.senuto.com/pl/baza-slow-kluczowych/"
      ]
    }
  ],
  "pagination": {
    "page_count": 1,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": 8,
    "limit": 10
  }
}
```

Zwraca frazy projektu Monitoringu, na które **rankuje więcej niż jeden URL** tej samej domeny (kanibalizacja) — wraz z liczbą wyszukiwań, CPC, cechami SERP oraz listą konkurujących URL-i. Analiza dotyczy wskazanego projektu (`project_id`) w zadanym zakresie dat.

| Fraza | Wyszukiwania/mies. | CPC | Liczba URL-i | Konkurujące URL-e | Snippety SERP |
| --- | --- | --- | --- | --- | --- |
| generator słów kluczowych | 320 | 6.4 | 2 | ["https://www.senuto.com/pl/blog/planer-slow-kluczowych/","https://www.senuto.com/pl/baza-slow-kluczowych/"] | ["ai_overview","people_also_ask","related_searches"] |
| senuto cennik | 320 | 3 | 2 | ["https://www.senuto.com/pl/cennik/","https://www.senuto.com/pl/blog/ai/"] | ["ai_overview","people_also_ask","related_searches"] |
| wyszukiwarka słów kluczowych | 480 | 6.9 | 2 | ["https://www.senuto.com/pl/baza-slow-kluczowych/","https://www.senuto.com/pl/blog/wyszukiwanie-slow-kluczowych/"] | ["ai_overview","people_also_ask","related_searches","video_thumbs","videos_pack"] |

_projekt dla senuto.com, 2026-06-20 → 2026-06-29. `searches` jest stringiem; `urls` to lista konkurujących adresów._

> **Ostrzeżenie:**
> To **narzędzie** (`tools/*`) — każde wywołanie **zużywa jednostkę dziennego limitu narzędzi** (`tools_daily_limit`). Patrz [Limity zapytań](/rate-limits).

---

## Żądanie

`POST` `/api/rank_tracker/tools/cannibalization/getKeywords`

Nagłówki: `Authorization: Bearer <token>`, `Content-Type: application/json`.

```jsonc filename="żądanie.jsonc"
{
  "project_id": null,
  "date_min": "2026-06-20",
  "date_max": "2026-06-29",
  "limit": 10,
  "page": 1,
  "order": { "prop": "searches", "dir": "desc" },
  "filtering": []
}
```

### Parametry

```ts
type RtCannibalizationGetKeywordsRequest = {
/** **Wymagane**. ID projektu Monitoringu (`getProject`). Realny `project_id` pobierzesz z `POST /api/rank_tracker/management/projects/getMyActiveProjects`. */
project_id: number;
/** Data początkowa zakresu (RRRR-MM-DD). */
date_min?: string;
/** Data końcowa zakresu (RRRR-MM-DD). */
date_max?: string;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
/** Sortowanie — obiekt `{ prop, dir }` (np. `searches`). */
order?: { prop: string; dir: 'asc' | 'desc' };
/** Grupy filtrów. Pusta tablica = brak filtrowania. */
filtering?: unknown[];
}
export default RtCannibalizationGetKeywordsRequest
```

## Odpowiedź

`data` to lista fraz z kanibalizacją; `pagination` jak w innych raportach.

```ts
type RtCannibalizationGetKeywordsResponse = {
success: boolean;
data: Array<{
  keyword: string;
  /** Liczba wyszukiwań/mies. — **string** */
  searches: string;
  cpc: number;
  /** Cechy SERP */
  snippets: string[];
  /** Liczba unikalnych URL-i konkurujących o frazę */
  unique_urls_count: number;
  /** Konkurujące adresy URL */
  urls: string[];
}>;
pagination: { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number };
}
export default RtCannibalizationGetKeywordsResponse
```

## Błędy

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

## Powiązane akcje

- `tools/cannibalization/getUrlsRanking` — ranking konkurujących URL-i dla pojedynczej frazy.