AI Overviews: rozkład pozycji (getDistribution)

Zwraca rozkład fraz projektu wyzwalających bloki AI Overviews Google po pozycjach organicznych. data to tablica dokładnie 50 kubełków (pos od 1 do 50) — dla każdej pozycji organicznej endpoint podaje, ile fraz projektu na tej pozycji wyzwala AI Overviews, z podziałem na frazy z obecnością domeny w bloku AIO (with_presence) i bez niej (without_presence). To inny raport niż wycofany raport AI Overviews w Analizie widoczności — ten endpoint nie jest oznaczony jako deprecated. Bez paginacji.

Żądanie

GET /api/rank_tracker/reports/ai_overviews/getDistribution

Nagłówki: Authorization: Bearer <token>. Parametry przekazuj w query stringu (np. ?project_id=87944). Realny project_id pobierzesz z POST /api/rank_tracker/management/projects/getMyActiveProjects.

Struktura żądania

{
  "project_id": null
}

curl --location --request GET 'https://api.senuto.com/api/rank_tracker/reports/ai_overviews/getDistribution?project_id=87944' \
  --header 'Authorization: Bearer $YOUR_TOKEN_HERE'

Parametry

Odpowiedź

Po pomyślnym żądaniu otrzymujesz data będące tablicą dokładnie 50 kubełków — po jednym dla każdej pozycji organicznej od 1 do 50. Każdy kubełek podaje liczbę fraz projektu na danej pozycji, które wyzwalają AI Overviews (total), oraz podział na frazy z obecnością domeny w bloku AIO (with_presence) i bez tej obecności (without_presence) — wraz z udziałami procentowymi. Odpowiedź nie ma paginacji.

W przykładach poniżej pokazano pierwsze kubełki oraz ostatni — w pełnej odpowiedzi jest ich 50. Projekt bez obecności w AI Overviews zwraca wszystkie wartości równe 0; struktura pozostaje taka sama.

{
  "success": true,
  "data": [
    { "pos": 1, "total": 0, "total_percentage": 0, "with_presence": 0, "with_presence_percentage": 0, "without_presence": 0, "without_presence_percentage": 0 },
    { "pos": 2, "total": 0, "total_percentage": 0, "with_presence": 0, "with_presence_percentage": 0, "without_presence": 0, "without_presence_percentage": 0 }
  ]
}

{
  "success": true,
  "data": [
    {
      "pos": 1,
      "total": 0,
      "total_percentage": 0,
      "with_presence": 0,
      "with_presence_percentage": 0,
      "without_presence": 0,
      "without_presence_percentage": 0
    },
    {
      "pos": 2,
      "total": 0,
      "total_percentage": 0,
      "with_presence": 0,
      "with_presence_percentage": 0,
      "without_presence": 0,
      "without_presence_percentage": 0
    },
    {
      "pos": 50,
      "total": 0,
      "total_percentage": 0,
      "with_presence": 0,
      "with_presence_percentage": 0,
      "without_presence": 0,
      "without_presence_percentage": 0
    }
  ]
}

Struktura odpowiedzi

Błędy

Powiązane akcje

• getStatistics — zbiorcze statystyki obecności w AI Overviews
• getKeywords — frazy projektu z danymi o obecności w AI Overviews
• getDistribution — rozkład fraz wyzwalających AI Overviews po pozycjach organicznych 1–50 (ta strona)
• getCompetitors — konkurenci w blokach AI Overviews
• getOpportunities — szanse na zdobycie obecności w AI Overviews
• getAioDetails — szczegóły bloku AI Overviews dla frazy
• getAioSources — źródła cytowane w blokach AI Overviews