Pozostałe: konkurencja fraz (`getData`)

POST/api/rank_tracker/tools/competition/getData

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.

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

żą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

Name	Type	Default
`project_id`	`number` Wymagane. ID projektu Monitoringu. Realny `project_id` pobierzesz z `POST /api/rank_tracker/management/projects/getMyActiveProjects`.
`mode`	`"common" \| "uncommon" \| "uncommon_domain"` Wymagane. Tryb: `common` \| `uncommon` \| `uncommon_domain`.
`gte`	`number` Wymagane. Dolna granica zakresu pozycji (globalna).
`lte`	`number` Wymagane. Górna granica zakresu pozycji (globalna).
`mainDomain`	`{ domain: string; gte: number; lte: number; }` Wymagane. Domena główna: obiekt `{ domain, gte, lte }`.
`compareDomains`	`{ domain: string; gte: number; lte: number; }[]` Wymagane (niepusta). Konkurenci: tablica `{ domain, gte, lte }`.
`limit`	`number` Liczba wierszy na stronę.	`10`
`page`	`number` Numer strony.	`1`

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.

Name	Type	Default
`success`	`boolean`
`data`	`{ [domain: string]: string \| number \| string[] \| null; keyword: string; searches: string; cpc: number; snippets: string[]; }[]`
`pagination`	`{ page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number; }`

Błędy

Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.

Powiązane akcje

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

Pozostałe: konkurencja fraz (getData)