Search

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.

Credits: 2 (refunded on failure).

get/api/v1/search/ai-overview

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/search/ai-overview
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

qstring required

The search query.

glstring

Country code (Google gl), e.g. "us", "gb", "de".

hlstring

Language code (Google hl), e.g. "en", "es".

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

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