Pozostałe: Landing pages · statystyki URL-i (`getUrlsStatistics`)

POST/api/rank_tracker/reports/landing_pages/getUrlsStatistics

Zwraca stronicowaną listę statystyk adresów URL (landing pages) projektu Rank Tracker w zadanym zakresie dat. Wymagane są project_id oraz zakres date_min–date_max w formacie YYYY-MM-DD (walidator UrlsStatisticsValidator).

Żądanie

POST /api/rank_tracker/reports/landing_pages/getUrlsStatistics

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

Struktura żądania

Podstawowy

żądanie-podstawowe.jsonc


{
  "project_id": null,
  "date_min": "2026-06-20",
  "date_max": "2026-06-29"
}

Rozszerzony

żądanie-rozszerzone.jsonc


{
  "project_id": null,
  "date_min": "2026-06-20",
  "date_max": "2026-06-29",
  "limit": 2,
  "page": 1
}

cURL


curl --location --request POST 'https://api.senuto.com/api/rank_tracker/reports/landing_pages/getUrlsStatistics' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer $YOUR_TOKEN_HERE' \
  --data-raw '{ "project_id": null, "date_min": "2026-06-20", "date_max": "2026-06-29", "limit": 2 }'

Parametry

Name	Type	Default
`project_id`	`number` Wymagane. ID projektu Rank Tracker. Musi należeć do użytkownika, inaczej zwracane jest `418` z `Unauthorized access`. Realny `project_id` pobierzesz z `POST /api/rank_tracker/management/projects/getMyActiveProjects`.
`date_min`	`string` Wymagane. Początek zakresu dat w formacie `YYYY-MM-DD`. Brak pola → `418` z `{"date_min":{"_required":"This field is required"}}`.
`date_max`	`string` Wymagane. Koniec zakresu dat w formacie `YYYY-MM-DD`. Uwaga (bug): gdy `date_min > date_max`, komunikat walidacji `DateRangeRules` jest odwrócony.
`filtering`	`{ filters: { key: string; match?: string; value: string \| number; complement?: boolean; }[]; conjunction?: "and" \| "or"; }[]` Filtrowanie listy adresów URL. Rejestr filtrów tego endpointu jest wąski — dozwolone klucze: `url` oraz alias `statistics.url.current`. ⚠️ Uwaga: ten endpoint (backend MySQL) na nieznany lub źle sformułowany filtr zwraca `HTTP 500` (nie `418`) — używaj wyłącznie kluczy z listy.
`limit`	`number` Rozmiar strony paginacji. Odbija się w `pagination.limit`.	`10`
`page`	`number` Numer strony paginacji.	`1`

Pułapki potwierdzone na produkcji:

Brak date_min/date_max → 418 z {"date_min":{"_required":"This field is required"},"date_max":{"_required":"This field is required"}}.
Znany bug: przy date_min > date_max komunikat walidacji DateRangeRules jest odwrócony — wskazuje niewłaściwe pole zakresu.
pagination.count jest zwracane jako string, pozostałe pola paginacji są liczbami.
Ten sam wiersz podaje metryki dwoma typami: na najwyższym poziomie visibility, top3, top10, top50, sum_searches i last_position to stringi, a w obiekcie statistics te same wartości są liczbami (poza searches, które zostaje stringiem). Rzutuj typy przed obliczeniami.

Odpowiedź

Po pomyślnym żądaniu otrzymujesz data (tablicę statystyk URL-i) oraz pagination. Projekt, który w podanym zakresie dat nie ma pozycjonujących się adresów, zwraca pustą tablicę.

Skrócona

przykładowa-odpowiedź (skrócona)


{
  "success": true,
  "data": [
    {
      "uid": "a0a93179e90261866c955748815a6b27",
      "url": "https://example.com/produkt/",
      "visibility": "7.52",
      "top3": "1",
      "top10": "1",
      "top50": "1",
      "sum_searches": "70",
      "best_keyword": "nazwa produktu",
      "last_position": "3",
      "page_path": "//example.com/produkt/"
    }
  ],
  "pagination": {
    "page_count": 1,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": "1",
    "limit": 3
  }
}

Struktura odpowiedzi

Name	Type	Default
`success`	`boolean` `true` przy powodzeniu; przy błędzie `false` i koperta z `error`
`data`	`{ uid: string; url: string; page_path: string; visibility: string; top3: string; top10: string; top50: string; sum_searches: string; last_position: string; best_keyword: string; statistics: { position: { ...; }; ... 5 more ...; top50: { ...; }; }; }[]` Statystyki adresów docelowych.
`pagination`	`{ page_count: number; current_page: number; has_next_page: boolean; has_prev_page: boolean; count: string; limit: number; }` Metadane paginacji

Błędy

Name	Type	Default
`success`	`false`
`data`	`{ error: { type: string; message: string; params?: Record<string, Record<string, string>>; }; }`

418 jest zwracane przy błędach walidacji (invalid_data) — nie tylko przy ograniczaniu liczby żądań. Brak dat → 418 z {"date_min":{"_required":"This field is required"},"date_max":{"_required":"This field is required"}}. Cudzy lub nieistniejący project_id zwraca 418 z Unauthorized access, a nie 404. Pamiętaj o odwróconym komunikacie DateRangeRules przy date_min > date_max.

Powiązane akcje

getUrlsStatistics — statystyki URL-i (landing pages) w zakresie dat (ta strona); jedyna zbadana akcja kontrolera LandingPages

Pozostałe: Landing pages · statystyki URL-i (getUrlsStatistics)