Porównanie dni (`getData`)

POST/api/rank_tracker/tools/compare_days/getData

Porównuje pozycje fraz wskazanej domeny w projekcie między wybranymi dniami pomiaru (compareDates). Dla każdej frazy zwraca wiersz z metadanymi (keyword, searches, cpc, snippets) oraz — pod kluczem każdej daty — pozycję (pos), URL i różnicę (diff) względem poprzedniej daty.

Podgląd · 6 z 7 kolumn

Fraza	Wyszukiwania/mies.	CPC	Poz. 20.06	Poz. 29.06	Różnica
senuto cennik	320	3	1	1	0

projekt dla senuto.com, dni 2026-06-20 i 2026-06-29. Kolumny dat pochodzą z compareDates (klucze-daty).

To narzędzie (tools/*) — zużywa jednostkę dziennego limitu narzędzi (tools_daily_limit). Patrz Limity zapytań.

Żądanie

POST /api/rank_tracker/tools/compare_days/getData

żądanie.jsonc


{
  "project_id": null,
  "domain": "senuto.com",
  "compareDates": [{ "date": "2026-06-20" }, { "date": "2026-06-29" }],
  "limit": 10,
  "page": 1,
  "order": { "prop": "searches", "dir": "desc" },
  "filtering": []
}

Parametry

Name	Type	Default
`project_id`	`number` Wymagane (lub `group_id`). ID projektu Monitoringu. Realny `project_id` pobierzesz z `POST /api/rank_tracker/management/projects/getMyActiveProjects`.
`group_id`	`number` Alternatywnie: ID grupy fraz zamiast całego projektu.
`domain`	`string` Domena, której pozycje porównujesz (w obrębie projektu).
`compareDates`	`{ date: string; }[]` Dni do porównania — tablica obiektów `{ date: "RRRR-MM-DD" }`.
`limit`	`number` Liczba wierszy na stronę.	`10`
`page`	`number` Numer strony.	`1`
`order`	`{ prop: string; dir: "asc" \| "desc"; }` Sortowanie `{ prop, dir }`.
`filtering`	`unknown[]` Grupy filtrów.

Odpowiedź

Każdy wiersz to fraza; pod kluczem każdej daty (z compareDates) znajduje się { pos, url, diff }.

Name	Type	Default
`success`	`boolean`
`data`	`{ [date: string]: string \| number \| { pos: number; url: string; diff?: number; } \| string[]; kid: string; 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/compare_serp/getData — porównanie SERP dla pojedynczej frazy między dniami.

Porównanie dni (getData)