geo-monitoring
geo-dashboard

Get Overview

AI Presence Overview: the Report Card for one experiment.

When scan_id is provided the header (AI Visibility, stability, average position, evidence, source ecosystem) is that scan only — the same load_dashboard_scan_selection resolver the Prompts / Changes tabs use, including completed_with_errors. Period is ignored for the evidence population so a historical ?scan= cannot keep showing the live rollup.

When omitted, headline AI Visibility Rate is the P2-cell rate over the selected period, computed from ALL eligible data-bearing runs (scheduled AND manual) whose canonical local day falls in the period, grouped by tenant-local day and pooled within each (cell, local day): the unweighted mean over measured prompt×provider cells of each cell's unweighted mean daily mention rate. Every measured cell is weighted equally regardless of usable samples or days measured; evidence depth surfaces only in Measurement Confidence, and multiple runs in one local day count as one measured day. Cells come from persisted results, so a prompt deactivated mid-period still counts for the days it ran (is_active never filters the rate). Failures/unavailability never become non-mentions. Scheduled-run health and the latest attempts still come from the canonical one-run-per-day load_period_run_selection (a distinct scheduler-reliability signal, not the metric's evidence population). Computed on read; nothing is persisted.

get/api/v1/geo/experiments/{experiment_id}/overview

Path parameters

experiment_idstring uuid required

Query parameters

period'7d' | '14d' | '30d' | '90d'
scan_idstring uuid nullable

Response

Successful Response

period'7d' | '14d' | '30d' | '90d' required
manual_snapshotboolean
ai_visibility_ratenumber nullable required
avg_position_when_mentionednumber nullable required
mentioned_usable_responsesinteger required
usable_responsesinteger required
eligible_cellsinteger required
methodology_versionstring required

Changes

No recorded changes to this endpoint across all 1 revision of this API.