Google AI Overview data
AI Overview API: Google AI Overview text, sources and rank in one call
Track Google AI Overviews by keyword. GET /serp returns the overview's text, markdown and every cited source, with organic rank, ads and People Also Ask from the same results page. 3 credits per page (from November 1, 2026, 8 when the overview has to be completed by rendering the page), and 3,000 free credits to start.
{ "searchTime": 0.17, "totalResults": 85000, "page": 1, "organic": [ { "position": 1, "title": "31.10. Connection Pools and Data Sources", "link": "www.postgresql.org/docs/…", "domain": "postgresql.org", "snippet": "For an environment without an application se…" }, { "position": 2, "domain": "medium.com", … }, { "position": 3, "domain": "stackoverflow.blog", … } ], "credits": 1}Is there an API for Google AI Overviews?
Google publishes no official AI Overview API. Searlo's GET /serp returns the AI Overview by default, from the rendered results page (text, markdown and cited sources with their domains) together with organic rank, ads, People Also Ask and related searches, for 3 credits per results page, or 8 from November 1, 2026 when the overview has to be completed by rendering the page.
When Google shows no AI Overview for the query, market and device, aioverview is null. The text is generated by Google, so it changes between fetches.
- Endpoint
- GET https://api.searlo.tech/api/v1/serp?q=…&gl=…&hl=… (AI Overview included by default; aioverview=false skips it)
- AI Overview object
- aioverview: { text, markdown, sources: [{ position, label, title, supportingCount, url, domain }] }, or null
- Same response
- organic, ads, videos, peopleAlsoAsk, relatedSearches, knowledgeGraph, aiModeAvailable
- Cost
- 3 credits per results page: $0.90 per 1,000 keyword checks at the Scale pack rate, $0.60 at Enterprise. From November 1, 2026, 8 credits ($2.40 per 1,000 at Scale) when the AI Overview had to be completed by rendering the page; the response says aioverview.rendered: true— our pricing
- Free to start
- 3,000 credits, which is up to 1,000 AI Overview checks, no card— our pricing
An AI Overview is the generated answer Google places above the results for many queries, with links to the pages it drew on. For SEO and content teams it raises three questions that a rank tracker alone cannot answer. Does this keyword show an AI Overview in this market? Which sources does it cite? Does our domain rank, get cited, or both?
GET /serp answers all three from one request. It reads the results page and, when the page shows an AI Overview, reads the overview in full once it has finished streaming (from the page as served, or from the page rendered in a browser when Google loads the overview later), and returns it as the aioverview object: the answer as plain text and as markdown, and a sources list with each citation's title, URL and domain. The organic results, ads, People Also Ask, related searches and knowledge graph from the same page come back alongside it, so citation share and organic rank are measured on the same snapshot.
What the response looks like
Illustrative values, real keys. Organic results are trimmed to one; the domains are placeholders.
{
"success": true,
"searchParameters": {
"q": "how do heat pumps work",
"gl": "us",
"hl": "en",
"page": 1,
"pages": 1,
"num": 10,
"device": "desktop",
"type": "serp"
},
"aioverview": {
"text": "A heat pump moves heat instead of generating it. In winter it pulls heat from outdoor air…",
"markdown": "A heat pump moves heat instead of generating it. In winter it pulls heat from outdoor air…\n### Main parts\n- Outdoor unit…",
"sources": [
{
"position": 1,
"label": "Example Energy",
"title": "How heat pumps work, explained",
"supportingCount": 2,
"url": "https://www.example-energy.org/heat-pumps",
"redirectUrl": null,
"resolved": true,
"domain": "example-energy.org"
},
{
"position": 2,
"label": "YouTube",
"title": "Heat pumps in 5 minutes",
"supportingCount": 0,
"url": "https://www.youtube.com/watch?v=abc123xyz00",
"redirectUrl": null,
"resolved": true,
"domain": "youtube.com"
}
]
},
"aiModeAvailable": true,
"organic": [
{
"position": 1,
"title": "How does a heat pump work?",
"url": "https://www.example-home.com/guides/heat-pump",
"redirectUrl": null,
"resolved": true,
"displayedUrl": "https://www.example-home.com › guides",
"domain": "example-home.com",
"snippet": "Heat pumps use refrigerant to carry heat…",
"date": null,
"page": 1
}
],
"ads": [],
"videos": [],
"peopleAlsoAsk": [{ "question": "What is the downside of a heat pump?" }],
"relatedSearches": [{ "query": "heat pump vs furnace" }],
"knowledgeGraph": null,
"pagesFetched": 1,
"gotoResolved": 2,
"fetchedAt": "2026-09-29T08:41:12.004Z",
"source": "searlo.tech(google_serp)",
"cached": false
}The aioverview object, field by field
| Field | What it holds |
|---|---|
| text | The AI Overview's answer as plain text, one block per line, with Google's buttons and feedback text removed |
| markdown | The same answer with headings (###) and list items (-) kept |
| sources[].position | The citation's place in the AI Overview's source list |
| sources[].title, label | The cited page's title, and the site name Google shows on the citation |
| sources[].url, domain | The cited URL and its domain. Google redirect links are resolved by default; resolved is false if that fails |
| sources[].supportingCount | The "+N" Google shows when more pages support the same citation |
| aiModeAvailable (top level) | Whether Google offered its AI Mode tab for the query. Searlo does not return AI Mode answers |
Parameters that matter for AI Overview tracking
| Parameter | Values | Use |
|---|---|---|
| q | Up to 400 characters | The keyword |
| aioverview | true (default) or false | Included by default: returns the AI Overview and waits for it to finish streaming. false skips it |
| gl, hl | Country (two letters), language | The market; AI Overviews differ by country and language |
| location | A country, by name or two-letter code | Applied as gl. A city or state returns 400 and is not charged: city-level targeting is not available yet |
| device | desktop (mobile and tablet return the desktop layout) | For the page an iPhone gets, use SERP HTML with device=ios |
| pages, num | 1 to 10 pages; 1 to 100 results requested per page | Deeper organic results; each page costs 3 credits and the AI Overview comes from page one |
| cache | true (default) or false | false forces a fresh fetch instead of a recent cached copy |
| googleGotoOrganic | true or false (default false) | Also resolve Google redirect links on organic results |
Check an AI Overview from curl, Python or Node
The Python example answers the citation question directly: is my domain cited in the AI Overview, and where does it rank organically on the same page?
curl "https://api.searlo.tech/api/v1/serp?q=how+do+heat+pumps+work&gl=us&hl=en" \
-H "x-api-key: YOUR_API_KEY"import requests
MY_DOMAIN = "example-energy.org"
resp = requests.get(
"https://api.searlo.tech/api/v1/serp",
params={"q": "how do heat pumps work", "gl": "us", "hl": "en"}, # AI Overview included by default
headers={"x-api-key": "YOUR_API_KEY"},
timeout=120, # the page is rendered and the AI Overview allowed to finish
)
resp.raise_for_status()
serp = resp.json()
aio = serp.get("aioverview")
cited = [s for s in (aio or {}).get("sources", []) if s["domain"].endswith(MY_DOMAIN)]
ranked = [o for o in serp["organic"] if o["domain"].endswith(MY_DOMAIN)]
print("AI Overview shown:", aio is not None)
print("Cited at source position:", [s["position"] for s in cited] or "not cited")
print("Organic position:", ranked[0]["position"] if ranked else "not in the results")const params = new URLSearchParams({
q: "how do heat pumps work",
gl: "us",
hl: "en",
}); // the AI Overview is included by default on /serp
const res = await fetch(`https://api.searlo.tech/api/v1/serp?${params}`, {
headers: { "x-api-key": "YOUR_API_KEY" },
});
const serp = await res.json();
if (!serp.aioverview) {
console.log("No AI Overview for this query, market and device");
} else {
console.log(serp.aioverview.markdown);
for (const s of serp.aioverview.sources) console.log(s.position, s.domain, s.url);
}Share of voice across AI Overviews and organic results
Run a keyword set through GET /serp on a schedule and three numbers come out per domain: how many of the keywords show an AI Overview at all, how often the domain is cited in those overviews, and where it ranks organically on the same page. Because both come from one snapshot, "cited but ranking eighth" and "ranking first but not cited" are real, comparable observations, not two tools' data joined after the fact.
For more than a handful of keywords, send them 20 at a time with POST /serp/batch. Pass "aioverview": true, because the batch endpoint leaves the AI Overview off by default. For larger sets, queue them as async tasks and collect the results later; the Bulk SERP API page has a 500-keyword example.
Measure citation share for a keyword set
Up to 20 keywords per batch; distinct keywords are billed once, 3 credits each; from November 1, 2026, 8 for a keyword whose AI Overview had to be completed by rendering the page.
from collections import Counter
import requests
keywords = [
"how do heat pumps work",
"heat pump vs furnace",
"are heat pumps worth it",
] # up to 20 per request
batch = requests.post(
"https://api.searlo.tech/api/v1/serp/batch",
json={"keywords": keywords, "gl": "us", "hl": "en", "aioverview": True},
headers={"x-api-key": "YOUR_API_KEY"},
timeout=600,
).json()
shown, citations = 0, Counter()
for row in batch["results"]:
if not row["success"] or not row.get("aioverview"):
continue
shown += 1
for domain in {s["domain"] for s in row["aioverview"]["sources"] if s["domain"]}:
citations[domain] += 1
print(f"AI Overview on {shown} of {batch['meta']['distinct']} keywords")
for domain, n in citations.most_common(10):
print(f"{domain}: cited on {n} keywords ({n / max(shown, 1):.0%} of AI Overviews)")What AI Overview tracking costs
| Pack | Price | Per 1,000 checks (3 credits) | Per 1,000 rendered checks (8 credits, from Nov 1) | Checks the pack covers at 3 credits |
|---|---|---|---|---|
| Micro | $3.99 | $2.40 | $6.40 | 1,666 |
| Starter | $9.99 | $1.50 | $4.00 | 6,666 |
| Builder | $29.99 | $1.20 | $3.20 | 25,000 |
| Scale | $74.99 | $0.90 | $2.40 | 83,333 |
| Pro | $199.99 | $0.66 | $1.76 | 300,000 |
| Enterprise | $799 | $0.60 | $1.60 | 1,333,333 |
Two worked examples. Tracking 500 keywords in three markets every week is about 6,500 checks a month, or 19,500 credits, which one Starter pack (20,000 credits, $9.99) covers. Tracking the same set every day is about 45,000 checks and 135,000 credits a month: $40.50 at the Scale rate, with one Scale pack ($74.99) lasting roughly 55 days. Both assume 3 credits a check: from November 1, 2026, checks whose overview has to be rendered cost 8, so budget for the share your own responses mark aioverview.rendered: true.
A page without an AI Overview costs the same 3 credits, because the page was fetched. A request that fails with a 4xx or 5xx status, or returns success: false, is refunded automatically.
What teams build on AI Overview data
- AI Overview tracking: which of your keywords trigger an AI Overview, per country, language and device, and how that changes week to week.
- Citation and source monitoring: whether your pages are cited, at which source position, and which competitors are cited instead.
- Share of voice with organic rank: citation share and organic position per domain, from the same results page.
- Content gaps: queries where you rank but are not cited, or are cited from a page that is not your best answer.
- Answer audits: store the text over time to see how Google summarises your brand, product or topic.
- Reporting: AI Overview presence and citations in the same dashboard as your rankings.
Related endpoints and pages
AI visibility API
The same citation question for ChatGPT, Microsoft Copilot and Gemini answers.
Rank Tracking API
Where a domain ranks for a keyword set, with stored history.
People Also Ask API
The People Also Ask questions from the same results page.
Bulk SERP API
Batch requests and async tasks for keyword sets of any size.
Google SERP API
Everything else on the results page, as JSON.
Pricing
Credit packs from $3.99. No subscription.
Honest limits
What the endpoint does not do, so you can plan around it.
- No official source. Google publishes no AI Overview API. This is the AI Overview as it appears on the rendered results page, parsed; when Google changes the page, parsing can lag until it is updated.
- Not every query has one. AI Overviews appear on some queries and not others, and differ by country, language, device and date. When none is shown, aioverview is null and the page is still a billed SERP.
- The text is non-deterministic. Google generates it, so two fetches minutes apart can differ in wording and in the sources they cite. Measure over repeated checks, not one.
- Cached copies. A repeat request can be answered from a short-lived cache, marked cached: true. Pass cache=false when you need a fresh fetch.
- Page one only. The AI Overview, People Also Ask and related searches come from the first results page; extra pages add organic results.
- No AI Mode answers. aiModeAvailable says Google offered AI Mode for the query; Searlo does not return AI Mode conversations.
- Slower than organic-only search. A call waits for the AI Overview to finish, and an overview Google loads late is completed by rendering the page, so it can take several seconds. Allow a generous client timeout (the examples use 120 seconds); GET /search/web is the fast 1-credit organic endpoint.
- Batch rows are billed even when they fail. A synchronous batch returns 200 and bills each distinct keyword; failed rows say whether they are retryable. Failed single requests and async tasks are refunded.
FAQ
AI Overview API: FAQ
What is a Google AI Overview?
An AI-generated summary Google shows at the top of the results for some queries; Google tested the feature as the Search Generative Experience (SGE). It answers the query in a few paragraphs or a list and links to the pages it drew on.
Does Searlo return the AI Overview text?
Yes. GET /serp returns aioverview.text (plain text), aioverview.markdown (with headings and list items kept) and aioverview.sources, the cited pages with title, URL, domain and position, by default; set aioverview=false to skip it. It costs 3 credits per results page, the same as a SERP without it; from November 1, 2026, 8 when the overview has to be completed by rendering the page, which the response marks aioverview.rendered: true.
Is there an official Google AI Overview API?
No. Google publishes no API for AI Overview content. Searlo reads the AI Overview from the rendered results page, which is why its presence and wording follow what Google shows at the moment of the fetch.
How do I track whether my site is cited in AI Overviews?
Run your keywords through GET /serp (the AI Overview is included by default) for each market you care about, and match your domain against aioverview.sources[].domain. Store the result per keyword and date. Because AI Overviews are non-deterministic, a citation rate over several checks is more reliable than a single yes or no.
Can I get AI Overviews for a specific country, city or device?
By country, yes. gl and hl set the country and language, and location also takes a country. City- and state-level targeting is not available yet: a city location returns 400 and is not charged, rather than a page searched from somewhere else. For the page an iPhone gets, use SERP HTML with device=ios. Coverage differs between markets, which is itself worth tracking.
What happens when a query has no AI Overview?
aioverview is null and the rest of the page (organic results, ads, People Also Ask, related searches) is returned as usual. The request is billed as a normal SERP, because the page was fetched.
How is this different from the AI visibility API?
This page covers Google's AI Overview on the search results page. The AI visibility API covers answers from ChatGPT, Microsoft Copilot and Gemini, which are separate products with their own citations.
Is Searlo affiliated with Google?
No. Searlo is an independent service and is not affiliated with, endorsed by or sponsored by Google. Google is a trademark of Google LLC. Searlo returns publicly visible results as JSON.
Check up to 1,000 AI Overviews free
3,000 free credits cover up to 1,000 checks. No card, no subscription.