← API Store
Search & SEOGoogle
Google AI Overview
GET /google/v1/ai-overviewThe AI Overview box of a normal Google results page, expanded, with its cited sources, text blocks and images. Accepts the same options as /google/v1/search (country, location, language, device, time, ...). Google does not show an overview for every query: then available is false and ai_overview is null. Costs the same as one search call.
Each call costs 3 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Search query (also accepted as query or keyword). Example: coffee machine |
country | string | Results for this country (Google gl, and the location defaults to it). Two-letter code. Example: us |
location | string | Search as if from this place, e.g. `Austin,Texas,United States` (Google uule). Default: the country. |
language | string | Interface language (Google hl), e.g. en, de, pt-BR. Example: en |
lr | string | Only results in these languages, e.g. `en` or `en|de`. |
cr | string | Only results from these countries, e.g. `US` or `US|GB`. |
time | string | Only results from the past hour, day, week, month or year; `day_3` = past 3 days. |
date_from | string | Only results from this date (YYYY-MM-DD). |
date_to | string | Only results up to this date (YYYY-MM-DD). |
sort | string | `date` sorts newest first (news). |
tbs | string | Raw Google tbs filter, combined with the options above. |
google_domain | string | Google domain, e.g. google.co.uk. |
safe | string | SafeSearch: on or off. |
autocorrect | string | 0 searches the query exactly as typed (no spelling correction). |
filter | string | 0 also shows near-duplicate results. |
site | string | Only these sites, comma-separated (site:). |
exclude_sites | string | Leave these sites out, comma-separated (-site:). |
filetype | string | Only this file type, e.g. pdf. |
device | string | desktop (default) or mobile results. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"ai_overview": {
"blocks": [
{
"tag": "h3",
"text": "AI Mode replied:"
},
{
"tag": "li",
"text": "Single-Serve Pod Machines: Use pre-packaged capsules (like K-Cups or Nespresso pods) for a single cup in under a minute with minimal cleanup…"
},
"… 5 more"
],
"images": [],
"sources": [],
"text": "Choosing a coffee machine depends on your preferred drink style, counter space, and how much time you want to spend brewing. Major options f…"
},
"available": true,
"cached": false,
"credits_used": 10,
"query": "coffee machine",
"search_parameters": {
"autocorrect": true,
"country": "us",
"cr": null,
"device": "desktop",
"filter": true,
"google_domain": "google.com",
"language": "en",
"limit": 10,
"location": "United States",
"lr": null,
"q": "coffee machine",
"safe": null,
"start": 0,
"tbs": null,
"type": "web"
}
} Response fields (29)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.ai_overview | object |
$.ai_overview.blocks | array |
$.ai_overview.blocks[] | object | string |
$.ai_overview.blocks[].tag | string |
$.ai_overview.blocks[].text | string |
$.ai_overview.images | array |
$.ai_overview.sources | array |
$.ai_overview.text | string |
$.available | boolean |
$.cached | boolean |
$.credits_used | integer |
$.query | string |
$.search_parameters | object |
$.search_parameters.autocorrect | boolean |
$.search_parameters.country | string |
$.search_parameters.cr | null |
$.search_parameters.device | string |
$.search_parameters.filter | boolean |
$.search_parameters.google_domain | string |
$.search_parameters.language | string |
$.search_parameters.limit | integer |
$.search_parameters.location | string |
$.search_parameters.lr | null |
$.search_parameters.q | string |
$.search_parameters.safe | null |
$.search_parameters.start | integer |
$.search_parameters.tbs | null |
$.search_parameters.type | string |