Google AI Overview API
Retrieve an AI Overview by query or by the short-lived ai_overview.page_token supplied by Google Search. A valid page without an overview returns feature_available=false.
Make a request
Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.
curl 'https://api.prismcrawl.com/v1/google/ai-overview' \
--request POST \
--header 'content-type: application/json' \
--header 'x-api-key: <PRISMCRAWL_API_KEY>' \
--data '{
"query": "how do solar panels work"
}'Supported parameters
| Parameter | Usage |
|---|---|
query | Text to search for on the selected service. |
country | Two-letter country or storefront code, such as us or gb. |
language | Provider-supported language code, such as en. |
device | Device presentation for the source request. desktop, mobile, tablet |
html | Return the encoded original response rather than parsed JSON. |
zero_trace | Do not archive source or parsed response artifacts. |
page_token | AI Overview token from Google Search; use within one minute. The token retains its original query, locale, and device. |
Structured results
Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.
addresscategorycoordinatesdescriptionidlatitudelinkslongitudenamephonepositionrankratingrating_maxrating_sourcereview_countsnippettextthumbnailtitletypeurlwebsiteSDKs and guides
The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.
- Python SDK:
pip install prismcrawl - Node.js SDK:
npm install prismcrawl