--- title: "Porównanie dni (`getData`)" source: https://docs.senuto.com/modules/rank_tracker/rt-compare-days-getData api: POST /api/rank_tracker/tools/compare_days/getData --- # Porównanie dni (`getData`) **`POST /api/rank_tracker/tools/compare_days/getData`** Przykładowe żądanie: ```json { "project_id": null, "domain": "senuto.com", "compareDates": [ { "date": "2026-06-20" }, { "date": "2026-06-29" } ], "limit": 10 } ``` Przykładowa odpowiedź: ```json { "success": true, "data": [ { "kid": "4de724d3f86734765dd07036c21f4105", "cpc": 3, "keyword": "senuto cennik", "searches": "320", "snippets": [ "ai_overview", "people_also_ask", "related_searches" ], "2026-06-20": { "pos": 1, "url": "https://www.senuto.com/pl/cennik/" }, "2026-06-29": { "pos": 1, "url": "https://www.senuto.com/pl/cennik/", "diff": 0 } } ], "pagination": { "page_count": 1, "current_page": 1, "has_next_page": false, "has_prev_page": false, "count": 1, "limit": 10 } } ``` 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. | Fraza | Wyszukiwania/mies. | CPC | Poz. 20.06 | Poz. 29.06 | Różnica | URL (29.06) | | --- | --- | --- | --- | --- | --- | --- | | senuto cennik | 320 | 3 | 1 | 1 | 0 | https://www.senuto.com/pl/cennik/ | _projekt dla senuto.com, dni 2026-06-20 i 2026-06-29. Kolumny dat pochodzą z compareDates (klucze-daty)._ > **Ostrzeżenie:** > To **narzędzie** (`tools/*`) — zużywa jednostkę dziennego limitu narzędzi (`tools_daily_limit`). Patrz [Limity zapytań](/rate-limits). --- ## Żądanie `POST` `/api/rank_tracker/tools/compare_days/getData` ```jsonc filename="żą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 ```ts type RtCompareDaysRequest = { /** **Wymagane** (lub `group_id`). ID projektu Monitoringu. Realny `project_id` pobierzesz z `POST /api/rank_tracker/management/projects/getMyActiveProjects`. */ project_id?: number; /** Alternatywnie: ID grupy fraz zamiast całego projektu. */ group_id?: number; /** Domena, której pozycje porównujesz (w obrębie projektu). */ domain?: string; /** **Dni do porównania** — tablica obiektów `{ date: "RRRR-MM-DD" }`. */ compareDates: Array<{ date: string }>; /** Liczba wierszy na stronę. @default 10 */ limit?: number; /** Numer strony. @default 1 */ page?: number; /** Sortowanie `{ prop, dir }`. */ order?: { prop: string; dir: 'asc' | 'desc' }; /** Grupy filtrów. */ filtering?: unknown[]; } export default RtCompareDaysRequest ``` ## Odpowiedź Każdy wiersz to fraza; pod kluczem każdej daty (z `compareDates`) znajduje się `{ pos, url, diff }`. ```ts type RtCompareDaysResponse = { success: boolean; data: Array<{ kid: string; keyword: string; searches: string; cpc: number; snippets: string[]; /** Klucz = data z compareDates (RRRR-MM-DD) */ [date: string]: { pos: number; url: string; diff?: number } | string | number | string[]; }>; pagination: { page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: number; limit: number }; } export default RtCompareDaysResponse ``` ## Błędy Błędy tego endpointu przychodzą we [wspólnej kopercie ze statusem `418`](/types/errors). ## Powiązane akcje - `tools/compare_serp/getData` — porównanie SERP dla pojedynczej frazy między dniami.