Kanibalizacja: URL-e frazy (`getUrlsRanking`)

POST/api/rank_tracker/tools/cannibalization/getUrlsRanking

Uszczegółowienie kanibalizacji dla jednej frazy: zwraca konkurujące URL-e wraz ze średnią pozycją (avg_pos) i liczbą pomiarów, w których dany URL wystąpił (occurrences) w zadanym zakresie dat. Frazę wskazujesz nazwą (keyword), a projekt przez project_id.

URL	Średnia pozycja	Liczba pomiarów
https://www.senuto.com/pl/baza-slow-kluczowych/	40.20	5
https://www.senuto.com/pl/blog/planer-slow-kluczowych/	31.75	4

projekt Rank Trackera, keyword „generator słów kluczowych”, 2026-06-20 → 2026-06-29. avg_pos jest stringiem (2 miejsca po przecinku).

Żądanie

POST /api/rank_tracker/tools/cannibalization/getUrlsRanking

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

żądanie.jsonc


{
  "project_id": null,
  "keyword": "generator słów kluczowych",
  "date_min": "2026-06-20",
  "date_max": "2026-06-29"
}

Parametry

Name	Type	Default
`project_id`	`number` Wymagane. ID projektu Monitoringu. Realny `project_id` pobierzesz z `POST /api/rank_tracker/management/projects/getMyActiveProjects`.
`keyword`	`string` Wymagane. Fraza (dopasowanie po `Keywords.name`).
`date_min`	`string` Data początkowa (RRRR-MM-DD).
`date_max`	`string` Data końcowa (RRRR-MM-DD).
`limit`	`number` Liczba wierszy na stronę.	`10`
`page`	`number` Numer strony.	`1`

keyword jest dopasowywane po dokładnej nazwie frazy — użyj wartości z tools/cannibalization/getKeywords (pole keyword). Nieistniejąca fraza da pustą listę.

Odpowiedź

data to lista konkurujących URL-i (url, avg_pos jako string, occurrences).

Name	Type	Default
`success`	`boolean`
`data`	`{ url: string; avg_pos: string; occurrences: number; }[]`
`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 — lista fraz z kanibalizacją (źródło keyword).

Kanibalizacja: URL-e frazy (getUrlsRanking)