AI Overviews: statystyki (getStatistics)
/api/rank_tracker/reports/ai_overviews/getStatisticsZwraca zbiorcze statystyki obecności domeny projektu w blokach AI Overviews Google dla fraz monitorowanych w projekcie Rank Tracker. Odpowiedź to obiekt z dziewięcioma metrykami (m.in. aio_visibility, aio_count, aio_sov), z których każda zawiera wartość bieżącą, poprzednią, różnicę, zmianę procentową oraz historię dzienną. 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/getStatistics
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
Podstawowy
{
"project_id": null
}Parametry
| Name | Type | Default |
|---|---|---|
project_id | numberWymagane. ID projektu Rank Tracker. Użytkownik musi mieć dostęp do projektu
(reguły |
Ten endpoint używa metody GET — parametry należy przekazywać w query stringu (kontroler wymusza allowMethod('get'); żądanie POST zwraca 405). Wymagany jest wyłącznie project_id; wskazanie cudzego lub nieistniejącego projektu skutkuje 418 (Unauthorized access) — dostęp weryfikują reguły ProjectAccessRules.
Odpowiedź
Po pomyślnym żądaniu otrzymujesz data będące obiektem z dziewięcioma metrykami AI Overviews. Każda metryka ma pola current, previous, diff, percent oraz history — mapę, w której kluczem jest uniksowy timestamp jako string, a wartością wartość metryki w danym dniu. Metryka aio_sov zawiera dodatkowo competitorsAvgSov i competitorsMaxSov. Odpowiedź nie ma paginacji.
history każdej metryki zawiera punkt na każdy dzień zakresu (w przykładach poniżej skrócono ją do 3 punktów). Projekt bez obecności w AI Overviews ma wartości metryk równe 0; struktura pozostaje taka sama.
Skrócona
{
"success": true,
"data": {
"aio_visibility": { "current": 0, "previous": 0, "diff": 0, "percent": 0, "history": { "1775088000": 0, "1775174400": 0, "1782950400": 0 } },
"aio_sov": { "competitorsAvgSov": 0, "competitorsMaxSov": 0, "current": 0, "previous": 0, "diff": 0, "percent": 0, "history": { "1775088000": 0, "1775174400": 0, "1782950400": 0 } },
"aio_potential": { "current": 0, "previous": 0, "diff": 0, "percent": 0, "history": { "1775088000": 859.5, "1775174400": 850.5, "1782950400": 0 } }
}
}Struktura odpowiedzi
| Name | Type | Default |
|---|---|---|
success | boolean
| |
data | { aio_visibility: AioMetric; aio_count: AioMetric; aio_avg_pos: AioMetric; aio_citations: AioMetric; aio_keywords_total: AioMetric; aio_sov: AioSovMetric; aio_potential: AioMetric; aio_utilized_potential: AioMetric; aio_unique_keywords: AioMetric; }Zbiorcze metryki obecności domeny projektu w AI Overviews |
Błędy
| Name | Type | Default |
|---|---|---|
success | false | |
data | { error: { type: string; message: string; params?: Record<string, Record<string, string>>; }; } |
Kontroler wymusza metodę GET (allowMethod('get')) — żądanie POST zwraca 405. Wskazanie projektu, do którego użytkownik nie ma dostępu, lub projektu nieistniejącego zwraca 418 z komunikatem Unauthorized access.
Powiązane akcje
getStatistics— zbiorcze statystyki obecności w AI Overviews (ta strona)getKeywords— frazy projektu z danymi o obecności w AI OverviewsgetDistribution— rozkład fraz wyzwalających AI Overviews po pozycjach organicznych 1–50getCompetitors— konkurenci w blokach AI OverviewsgetOpportunities— szanse na zdobycie obecności w AI OverviewsgetAioDetails— szczegóły bloku AI Overviews dla frazygetAioSources— źródła cytowane w blokach AI Overviews