Settings Google AI Overview takes
You describe the task in plain words and your AI assistant fills these in. In code you pass them yourself.
| Setting | What it controls | Tip |
|---|---|---|
| Query | Search query, up to 4,000 characters. Required unless ludocid or kgmid is supplied. | Optional · up to 4000 characters |
| Cr | Country restrictions such as 'countryUS', joined with '|'. | Optional |
| Country | Lowercase two-letter country code for result localization, such as 'us'. | Optional |
| Language | Interface and result language, such as 'en', 'en-GB', or 'de'. Default 'en'. | Optional |
| Lr | Language restrictions such as lang en, joined with '|'. | Optional |
| Oq | Original query associated with an autocomplete selection. | Optional · up to 2048 characters |
| Si | Opaque cached Google search context from a previous response. | Optional · up to 4096 characters |
| Ibp | Google layout or expansion control token. | Optional · up to 4096 characters |
| Lat | Latitude of the search origin. Requires lon; conflicts with location and uule. | Optional · -90 to 90 |
| Lon | Longitude of the search origin. Requires lat; conflicts with location and uule. | Optional · -180 to 180 |
| Num | Best-effort first-page result count, 1-10. | Optional · 1 to 10 |
| Pws | Personalization control; '0' asks for non-personalized results. | Optional · one of 0, 1 |
| Tbm | Google vertical: lcl (local), vid (video), nws (news), shop (shopping), pts (patents). Images are not supported. | Optional · one of lcl, vid, nws, shop, pts |
| Tbs | Google native date or search filter string. | Optional · up to 4096 characters |
| Uds | Opaque Google filter token from a previous response. | Optional · up to 4096 characters |
| As Query | Additional all-of search terms. | Optional · up to 2048 characters |
| Lsig | Opaque Knowledge Graph or local-pack signature from a previous response. | Optional · up to 4096 characters |
| Nfpr | Set '1' to exclude auto-corrected queries. | Optional · one of 0, 1 |
| Safe | Adult-content filtering. | Optional · one of active, off |
| Uule | Pre-encoded Google location token. Conflicts with location. | Optional · up to 2048 characters |
| As dt | Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch. | Optional · one of i, e |
| As eq | Phrase the results must not contain. | Optional · up to 2048 characters |
| As lq | Only pages that link to this URL. | Optional · up to 4096 characters |
| As oq | Any-of search terms. | Optional · up to 2048 characters |
| As rq | Pages related to this URL. | Optional · up to 4096 characters |
| Gs lp | Google gs_lp value associated with an autocomplete selection. | Optional · up to 4096 characters |
| Kgmid | Knowledge Graph machine ID, such as '/m/0k8z', to search for one entity. | Optional · up to 512 characters |
| Start | Result offset. Default 0. | Optional |
| As epq | Exact phrase the results must contain. | Optional · up to 2048 characters |
| As nhi | Upper bound of an inclusive numeric range. Requires as_nlo. | Optional |
| As nlo | Lower bound of an inclusive numeric range. Requires as_nhi. | Optional |
| As qdr | Quick date range: d, w, m, or y with an optional count, such as 'm3'. | Optional |
| Device | Device layout Google renders. Default 'desktop'. | Optional · one of desktop, tablet, mobile |
| Filter | Set '0' to include similar results Google would otherwise omit. | Optional · one of 0, 1 |
| Radius | Search-bias radius in meters around location or lat/lon: 1-199 on desktop, 1-1,000 on tablet and mobile. | Optional · 1 to 1000 |
| Ludocid | Google local CID to search for one entity instead of a query. | Optional · up to 128 characters |
| Sclient | Google client identifier such as 'gws-wiz-serp'. | Optional · up to 64 characters |
| Location | Human-readable search origin, such as 'Austin, Texas'. Conflicts with uule. | Optional · up to 512 characters |
| Peek pws | Personalization peek flag, forwarded unchanged. | Optional · one of 0, 1 |
| Color scheme | Result color presentation. | Optional · one of light, dark |
| As sitesearch | Site hostname to include or exclude. | Optional · up to 253 characters |
| Google domain | Google domain to query, such as 'google.com' or 'google.co.uk'. Default 'google.com'. | Optional |
How to use Google AI Overview with your AI assistant
Connect AI/ML API
Click Try it now, pick your client and add the MCP server. You sign in with your AI/ML API account once.
Describe the task
Say what you need in one sentence.
Get the result
Your assistant runs Google AI Overview and shows what came back.
Keep going in the chat
Ask it to filter, compare or summarize the result, or to save it as a table.
Ways to use it
- For an AI-answer research brief: check a Google query for an AI Overview and read the generated summary when one exists. Some queries have no overview.
Google AI Overview in your code
In your code
REST · your AI/ML API key, JSON records back
The same tool runs over REST with your AI/ML API key, so a backend, a script or a scheduled job can call Google AI Overview directly. Start with the Toolbox REST quickstart.
Pricing
Pay as you goBilled per run from your AI/ML API balance
- No subscription
- No seat fee
- One balance for every tool
Each run is billed from your AI/ML API balance, with no subscription or seat fee. Check the current price in your dashboard before large runs.
FAQ
Do I need a separate account for Google AI Overview?
No. It runs on your AI/ML API account and balance, from your AI assistant over MCP or from your code over REST.
Which AI assistants can use it?
Claude, ChatGPT, Cursor, Hermes, OpenClaw and other MCP clients. Add the AI/ML API MCP server once with the MCP quickstart.
Run Google AI Overview from your assistant
Connect once, then ask for it in plain words.