Google AI Overview
Fetch Google's AI Overview plus the full SERP, with cited sources
POST
https://api.anakin.io/v1/wire/taskFetch the AI Overview Google shows above organic results, plus the surrounding SERP — organic results, People-Also-Ask, knowledge panel, and more. Highly geo-dependent. Run it with the google_ai_overview action on POST /v1/wire/task.
Catalog: google_ai_mode · action_id: google_ai_overview · Credits: 2 / call · Auth: none
Request Body
{
"action_id": "google_ai_overview",
"params": { "query": "best CRM for small teams", "country": "us" }
}| Parameter | Type | Description |
|---|---|---|
action_id required | string | Set to google_ai_overview |
params.query required | string | The search query (max 2048 chars) |
params.country | string | 2-letter ISO country for the search locale (239 supported). Default in |
params.language | string | Language of the results and AI Overview (Google hl), e.g. fr, de, en, or with region fr-CH |
params.location | string | Location override: lat,lng[,radius_m] or a canonical place |
params.uule | string | Ready-made Google UULE cookie value (overrides location) |
params.page | integer | SERP page (1–10). Page 1 = AI Overview + organic. Default 1 |
params.html | boolean | Return a link to the full SERP snapshot instead of inline HTML. Default false |
params.paa_aioverview | boolean | Hydrate People-Also-Ask items with their own AI-Overview markdown. Default false |
params.device | string | User-agent profile (desktop, desktop_chrome, mobile, …). Default desktop |
params.resolve_goto | boolean | Resolve Google's /goto redirect links to the real URL for organic results and cited sources that show only a site root. Default false |
Code Examples
curl -X POST http://staging-alb-1217701800.ap-south-1.elb.amazonaws.com/v1/wire/task \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"action_id": "google_ai_overview",
"params": { "query": "best CRM for small teams", "country": "us" }
}'import requests
res = requests.post(
'https://api.anakin.io/v1/wire/task',
headers={'X-API-Key': 'your_api_key'},
json={'action_id': 'google_ai_overview', 'params': {'query': 'best CRM for small teams', 'country': 'us'}},
)
job_id = res.json()['job_id']const res = await fetch('http://staging-alb-1217701800.ap-south-1.elb.amazonaws.com/v1/wire/task', {
method: 'POST',
headers: { 'X-API-Key': 'your_api_key', 'Content-Type': 'application/json' },
body: JSON.stringify({
action_id: 'google_ai_overview',
params: { query: 'best CRM for small teams', country: 'us' },
}),
});
const { job_id } = await res.json();Response
202 Accepted{ "status": "processing", "job_id": "…", "poll_url": "/v1/wire/jobs/…" }Poll GET /v1/wire/jobs/{id} until status: "completed":
{
"status": "completed",
"credits_used": 2,
"execution_ms": 16797,
"data": {
"status": "ok",
"data": {
"overview_text": "…", "overview_markdown": "…", "overview_markdown_cited": "…", "source_count": 7,
"sources": [
{ "url": "https://…", "title": "…", "domain": "…", "snippet": "…", "hostname": "…", "source_type": "web" }
],
"claim_references": [
{ "text": "HubSpot CRM: Best for free onboarding…", "start": 0, "end": 40,
"references": [{ "source": "YouTube", "url": "https://…", "more": 0, "source_index": 0 }] }
],
"organic": [], "featured_snippet": {}, "knowledge_panel": {},
"related_questions": [], "related_searches": [], "top_stories": [], "videos": [],
"products": [], "discussions": [], "what_people_are_saying": [],
"serp_layout": [], "device": "desktop", "page": 1
},
"meta": { "action_id": "google_ai_overview", "catalog_slug": "google_ai_mode", "envelope_version": "v1" }
}
}| Field | Type | Description |
|---|---|---|
data.data.overview_text | string | The AI Overview text, also as overview_markdown. overview_markdown_cited is the same markdown with a [n] marker after each cited claim. null when Google serves no overview |
data.data.ads | object or null | Text ads on the page: { top: [...], bottom: [...], count }; null when none were shown |
data.data.related_searches | array | Related search suggestions |
data.data.overview_markdown | string | The AI Overview rendered as Markdown (alongside overview_text) |
data.data.sources | array | AI Overview citations — { url, title, domain, snippet, hostname, source_type } |
data.data.claim_references | array | Where each source is cited in the overview — the sharpest GEO signal. One entry per claim: text, its character offsets in overview_text (start/end), and references: [{ source, url, more, source_index }] (lead source, more = "+N" grouped count, source_index into sources[]) |
data.data.source_count | number | Number of cited sources |
data.data.organic | array | Organic SERP results |
data.data.related_questions | array | People-Also-Ask items |
data.data.related_questions_answers | array | People-Also-Ask items hydrated with their own answers, when present |
data.data.related_sources | array | Sources from the "related" / people-also-search modules, when present |
data.data.what_people_are_saying | array | The "What people are saying" forum/discussion block (Reddit/Quora etc.), when present |
data.data.featured_snippet | object | Featured snippet module when present |
data.data.knowledge_panel | object | Knowledge panel module when present |
data.data.local_pack | array | Local pack module when present |
data.data.top_stories | array | Top stories module when present |
data.data.videos | array | Videos module when present |
data.data.products | array | Shopping/product module when present |
data.data.shopping | array | Shopping module when present |
data.data.discussions | array | Discussions / forum module when present |
data.data.serp_layout | array | Order of SERP modules on the page |
Google doesn't serve an AI Overview for every query/geo — check
overview_textfornullbefore relying on it (the SERP modules are still returned). Uselocation/uulefor city-level targeting. Billed only on success.