Porównanie SERP (`getData`)

POST/api/rank_tracker/tools/compare_serp/getData

Porównuje wyniki wyszukiwania (SERP) dla pojedynczej frazy między wybranymi dniami — dla każdej pozycji TOP (do position) pokazuje, jaka domena/URL ją zajmowała w danym dniu oraz zmianę (diff). Pozwala zobaczyć, jak zmienił się układ SERP wokół monitorowanej frazy.

Pozycja	Domena 20.06	URL 20.06	Domena 29.06	Różnica
1	www.seoptimer.com	https://www.seoptimer.com/pl/keyword-generator	pl.semrush.com	-1

projekt Rank Trackera, keyword „generator słów kluczowych”, dni 2026-06-20 i 2026-06-29. Kolumny dat pochodzą z compareDates.

To narzędzie (tools/*) — zużywa jednostkę tools_daily_limit. keyword musi istnieć (dopasowanie po Keywords.name) — inaczej 418 (invalid_data).

Żądanie

POST /api/rank_tracker/tools/compare_serp/getData

żądanie.jsonc


{
  "project_id": null,
  "keyword": "generator słów kluczowych",
  "position": 10,
  "compareDates": [{ "date": "2026-06-20" }, { "date": "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`).
`position`	`number` Maksymalna pozycja SERP do porównania (zakres 1..position).	`10`
`compareDates`	`{ date: string; }[]` Dni do porównania — tablica `{ date: "RRRR-MM-DD" }`.

Odpowiedź

Każdy wiersz to slot pozycji SERP; pod kluczem każdej daty { position, domain, url, diff }.

Name	Type	Default
`success`	`boolean`
`data`	`{ [date: string]: number \| { position: number; domain: string; url: string; diff?: number; }; position: 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/compare_days/getData — porównanie pozycji fraz domeny między dniami.

Porównanie SERP (getData)