Why does it cost 2 credits?

AI Overviews only render in a full JavaScript search page, so the endpoint renders the SERP in a real browser to capture the overview and its citations reliably. Cache hits (same query within 24 hours) are free.

What if there is no AI Overview for my query?

You get has_ai_overview: false — a valid, useful answer for tracking which queries trigger an overview at all.

Which country does the overview reflect?

Whatever you pass as gl / hl (default US, English). AI Overview availability varies by market.

Data APIs / Google AI Overview

Google AI Overview API

Get the AI Overview Google shows for a query: the generated answer and the list of sources it cites, with titles and URLs. Built for tracking AI visibility — see which pages Google's answer engine trusts, and whether yours is one of them.

Get 10 free credits API reference

From 2 credits per call · cache hits free · failed calls refunded · no card for the free tier

One request, structured data and markdown

Every endpoint accepts format=json, markdown, or both. Use the JSON to filter and store; drop the markdown straight into a prompt.

Whether an AI Overview appears for the query
The overview text as clean markdown
Every cited source with title and URL
Country (gl) and language (hl) targeting

request

curl 'https://scrapewhale.dev/api/v1/search/ai-overview?q=how+to+clean+running+shoes&format=json' \
  -H 'Authorization: Bearer <api-key>'

response · json

{
  "extractor": "google-ai-overview",
  "creditsCharged": 2,
  "data": {
    "query": "how to clean running shoes",
    "has_ai_overview": true,
    "text": "To clean running shoes, remove the laces and insoles, brush off loose dirt…",
    "sources": [
      { "title": "How to Clean Running Shoes | Nike Help", "url": "https://www.nike.com/…" }
    ]
  }
}

Abridged.

Endpoints

1 endpoint in this family. Full parameter reference and a try-it console are in the API docs.

get/api/v1/search/ai-overview2 credits

Google AI Overview

Google’s full AI Overview for a query — the rich multi-source answer shown above the results: ordered text blocks (paragraphs, headings, lists) with [n] citation markers linking into a references list of cited sources. The key input for answer-engine (GEO) monitoring: see what Google’s AI says about a topic and which domains it cites. Overviews exist for roughly half of queries and Google generates them probabilistically — when none is produced the request fails with empty_result and the credits are refunded (retrying later can succeed). Cached for 24 hours.

q *: The search query.
gl: Country code (Google gl), e.g. "us", "gb", "de".
hl: Language code (Google hl), e.g. "en", "es".

Try in Playground

What teams use it for

AI visibility tracking

Monitor your money keywords weekly and log whether your domain is cited.

Citation gap analysis

Collect the sources Google cites across a topic and see which competitors dominate.

Content briefs

Read what the overview says for a query before writing the page that should be cited.

Frequently asked questions

Start with 10 free credits

No card required. Run any endpoint from the Playground, then create an API key when you are ready to automate.

Create free account See pricing