Skip to main content
Ask your client:
Where am I winning in AI Overviews this week?

​
What the agent does

The agent chains two reporting tools:
  1. reporting_get_available_dates — lists the metric snapshot dates (YYYY-MM-DD, ascending) for the current account.
  2. reporting_get_wins with startDate and endDate set to the first and last snapshot of the period — returns everything new between the two snapshots.
Wins are computed between snapshots: dates must come from reporting_get_available_dates, and endDate defaults to the most recent snapshot when omitted.

​
How to read the result

reporting_get_wins returns totals plus per-snapshot detail:
  • rankingWins — questions that newly rank this period. Each win carries currentOrganicPosition (best organic position, null if the question is only in the AI Overview) and currentAiOverviewPosition (best AI Overview position, null if only organic). A win with a currentAiOverviewPosition is an AI Overview win.
  • mentionWins — questions where your brand is newly mentioned in the AI Overview, with currentMentionPosition (1-indexed position in the AI Overview brands array).
  • positionMovements — per-question timelines with organicPosition, aiOverviewPosition, and mentionPosition per snapshot, plus organicDelta and aiOverviewDelta (positive = improved, moved towards position 1; null when the position is absent at either end).

​
Digging deeper with the content planner

To see the AI Overview state across all tracked questions — not just new wins — the agent can call content_planner_list_seed_terms or content_planner_list_questions in the default google-ranking mode. Per question, the search intelligence fields include:
  • isAIOverview / hasAiOverview — whether the domain is referenced in, and whether the SERP has, an AI Overview
  • aiOverviewPositions — every AI Overview position where the domain is referenced (null if not in the AI Overview)
  • bestAiOverviewPosition — the best (lowest) of those positions
  • mentionPosition — 1-indexed position of the selected brand in the AI Overview mentions array

​
See also