---
title: "Pozostałe: konkurencja fraz (`getData`)"
source: https://docs.senuto.com/modules/rank_tracker/rt-competition-getData
api: POST /api/rank_tracker/tools/competition/getData
---

# Pozostałe: konkurencja fraz (`getData`)

**`POST /api/rank_tracker/tools/competition/getData`**

Przykładowe żądanie:

```json
{
  "project_id": null,
  "mode": "uncommon",
  "gte": 1,
  "lte": 50,
  "mainDomain": {
    "domain": "senuto.com",
    "gte": 1,
    "lte": 50
  },
  "compareDomains": [
    {
      "domain": "pl.semrush.com",
      "gte": 1,
      "lte": 50
    }
  ],
  "limit": 10
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "keyword": "wyszukiwanie slow kluczowych",
      "searches": "480",
      "cpc": 6.88,
      "snippets": [
        "ai_overview",
        "people_also_ask",
        "related_searches",
        "video_thumbs",
        "videos_pack"
      ],
      "senuto.com": null,
      "pl.semrush.com": 10
    }
  ],
  "pagination": {
    "page_count": 1,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": 8,
    "limit": 10
  }
}
```

Porównuje frazy między **domeną główną** a **konkurentami** w projekcie, w wybranym zakresie pozycji. Tryb (`mode`) decyduje, co zwrócić:

- `common` — frazy, na które rankują **wszystkie** porównywane domeny,
- `uncommon` — frazy, na które rankuje **konkurent, a nie** domena główna (luki),
- `uncommon_domain` — frazy unikalne dla **domeny głównej**.

| Fraza | Wyszukiwania/mies. | CPC | Snippety SERP |
| --- | --- | --- | --- |
| wyszukiwanie slow kluczowych | 480 | 6.88 | ["ai_overview","people_also_ask","related_searches","video_thumbs","videos_pack"] |
| wyszukiwarka słów kluczowych | 480 | 6.9 | ["ai_overview","people_also_ask","related_searches","video_thumbs","videos_pack"] |

_projekt Rank Trackera, mode uncommon, senuto.com vs pl.semrush.com. Pozycje per domena są pod kluczami-domenami (np. „pl.semrush.com”: 10, „senuto.com”: null) — mają kropki w nazwie, więc nie są tu kolumnami; komplet w JSON._

> **Ostrzeżenie:**
> To **narzędzie** (`tools/*`) — zużywa jednostkę `tools_daily_limit`. `mainDomain` i każdy wpis `compareDomains` to **obiekty** `{ domain, gte, lte }` (zakres pozycji); brak wymaganych pól → `418` (`invalid_data`).

---

## Żądanie

`POST` `/api/rank_tracker/tools/competition/getData`

```jsonc filename="żądanie.jsonc"
{
  "project_id": null,
  "mode": "uncommon",
  "gte": 1,
  "lte": 50,
  "mainDomain": { "domain": "senuto.com", "gte": 1, "lte": 50 },
  "compareDomains": [{ "domain": "pl.semrush.com", "gte": 1, "lte": 50 }]
}
```

### Parametry

```ts
type RtCompetitionRequest = {
/** **Wymagane**. ID projektu Monitoringu. Realny `project_id` pobierzesz z `POST /api/rank_tracker/management/projects/getMyActiveProjects`. */
project_id: number;
/** **Wymagane**. Tryb: `common` | `uncommon` | `uncommon_domain`. */
mode: 'common' | 'uncommon' | 'uncommon_domain';
/** **Wymagane**. Dolna granica zakresu pozycji (globalna). */
gte: number;
/** **Wymagane**. Górna granica zakresu pozycji (globalna). */
lte: number;
/** **Wymagane**. Domena główna: obiekt `{ domain, gte, lte }`. */
mainDomain: { domain: string; gte: number; lte: number };
/** **Wymagane** (niepusta). Konkurenci: tablica `{ domain, gte, lte }`. */
compareDomains: Array<{ domain: string; gte: number; lte: number }>;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
}
export default RtCompetitionRequest
```

## Odpowiedź

Każdy wiersz to fraza; pozycja każdej porównywanej domeny znajduje się pod **kluczem = nazwa domeny** (wartość `null`, gdy domena nie rankuje). Klucze-domeny zawierają kropki, dlatego w tabeli powyżej pokazano tylko pola wspólne.

```ts
type RtCompetitionResponse = {
success: boolean;
data: Array<{
  keyword: string;
  searches: string;
  cpc: number;
  snippets: string[];
  /** Klucz = nazwa domeny (np. "senuto.com"); wartość = pozycja lub null */
  [domain: string]: number | null | string | string[];
}>;
pagination: { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number };
}
export default RtCompetitionResponse
```

## Błędy

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

## Powiązane akcje

- `tools/cannibalization/getKeywords` — frazy z wieloma URL-ami tej samej domeny.