// Google documentation

Google AI Overview API

Google's AI Overview for any query as ordered text blocks with cited references, in one call with no page token, for any country, language and device.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/google/ai-overview

// from request to code

Integrate Google AI Overview

Build your request and copy it into your stack. Or let your coding agent set it up.

APIGoogle AI Overview

QueryGoogle Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied. Maximum characters: 2048

More options 41

Query or entity

Supply a query, Google local CID, or Knowledge Graph machine ID.

Local CIDGoogle local CID used to search for one entity. Maximum characters: 128 Pattern: ^\d+$Knowledge Graph IDGoogle Knowledge Graph machine ID, such as /m/0k8z. Maximum characters: 512

Geography

Choose location, uule, or latitude and longitude. Radius depends on device.

LocationHuman-readable city-level location encoded to UULE by Litescrape. Conflicts with uule and lat/lon. Maximum characters: 512UULEPre-encoded Google location value. Conflicts with location and lat/lon. Maximum characters: 2048LatitudeLatitude from -90 through 90. Requires lon and conflicts with location and uule. Minimum: -90 Maximum: 90LongitudeLongitude from -180 through 180. Requires lat and conflicts with location and uule. Minimum: -180 Maximum: 180Radius (meters)Decimal search-bias radius in meters. Requires location or lat/lon. Desktop: 1–199; tablet/mobile: 1–1,000. Minimum: 1 Maximum: 1000

Knowledge Graph controls

Pass Google entity, layout, and cached-context tokens without rewriting them.

lsigOpaque Knowledge Graph or local-pack signature. Maximum characters: 4096siOpaque cached Google search context. Maximum characters: 4096ibpGoogle layout or expansion control. Maximum characters: 4096udsOpaque Google filter token. Maximum characters: 4096Color schemeGoogle result color presentation.

Localization

Control Google domain, language, country, restrictions, and device.

Google domainResults use google.com. Use gl, hl, cr, lr or geography for localization.CountryLowercase two-letter country localization code. Pattern: ^[a-z]{2}$LanguageGoogle interface and result language code. Pattern: ^[a-z]{2,3}(?:-[A-Za-z]{2,8})?$Country restrictOne or more countryXX restrictions joined with |. Pattern: ^country[A-Z]{2}(?:\|country[A-Z]{2})*$Language restrictOne or more lang_xx restrictions joined with |. Pattern: ^lang_[a-z]{2,3}(?:\|lang_[a-z]{2,3})*$DeviceRequest device profile and radius bound.

Filtering & pagination

Apply native Google filtering, vertical, date, safety, and offset controls.

Search filterGoogle native date or search filter string. Maximum characters: 4096Safe searchGoogle adult-content filtering.Auto-correctionGoogle auto-correction control.Similar resultsGoogle similar-result filtering control.PersonalizationGoogle personalization control; 0 asks for non-personalized results.Personalization peekGoogle personalization peek flag, forwarded unchanged.VerticalGoogle vertical: lcl, vid, nws, shop, or pts. For image searches, use /api/google/images.Start offsetNon-negative Google result offset. Minimum: 0Results requestedBest-effort first-page result count, 1 to 10. Minimum: 1 Maximum: 10

Advanced query

Expose Google’s complete advanced-search parameter family.

Original queryOriginal query associated with an autocomplete selection. Maximum characters: 2048Autocomplete lineageGoogle gs_lp value associated with an autocomplete selection. Maximum characters: 4096Search clientGoogle client identifier such as gws-wiz-serp. Maximum characters: 64 Pattern: ^[A-Za-z0-9._-]+$Site modeIncludes or excludes as_sitesearch. Requires as_sitesearch.Exact phraseExact phrase query. Maximum characters: 2048Exclude phraseExcluded phrase query. Maximum characters: 2048Links to URLRequire results that link to this URL. Maximum characters: 4096Range lowInclusive range lower bound. Requires as_nhi. Minimum: 0Range highInclusive range upper bound. Requires as_nlo. Minimum: 0Any termsAny-of search terms. Maximum characters: 2048All termsAdditional all-of search terms. Maximum characters: 2048Date rangeQuick range d, w, m, or y with an optional positive count. Pattern: ^[dwmy](?:[1-9][0-9]*)?$Related to URLFind pages related to this URL. Maximum characters: 4096Site hostnameSite hostname to include or exclude. Maximum characters: 253

Your request updates the code instantly.

Open the Playground →

https://ecll-litescrape-v3--site-mcp.modal.run/mcp

Add the server URL to your MCP client with an Authorization: Bearer header containing your API key, then call the tool below.

tools/call.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ai_overview",
    "arguments": {
      "q": "what is a heat pump",
      "gl": "us",
      "hl": "en",
      "device": "desktop"
    }
  }
}

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/google/ai-overview with Content-Type: application/json and your Authorization: Bearer header.

{
  "q": "why is the sky blue"
}

// request reference

Google AI Overview parameters

Send query parameters with GET /api/google/ai-overview. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Query and entity selectors

q

QueryConditional

Google Search query, up to 2,048 characters.

Type string · GET query or POST JSON

Example / input hint: coffee shops in Austin

Required unless ludocid or kgmid is supplied.
Maximum characters: 2048

ludocid

Local CIDConditional

Google local CID used to search for one entity.

Type string · GET query or POST JSON

Example / input hint: 1234567890123456789

Maximum characters: 128
Pattern: ^\d+$

kgmid

Knowledge Graph IDConditional

Google Knowledge Graph machine ID, such as /m/0k8z.

Type string · GET query or POST JSON

Example / input hint: /m/0k8z

Maximum characters: 512

Geographic location

location

LocationOptional

Human-readable city-level location encoded to UULE by Litescrape.

Type string · GET query or POST JSON

Example / input hint: Austin, Texas

Conflicts with uule and lat/lon.
Maximum characters: 512

uule

UULEOptional

Pre-encoded Google location value.

Type string · GET query or POST JSON

Example / input hint: w+CAIQICI…

Conflicts with location and lat/lon.
Maximum characters: 2048

lat

LatitudeOptional

Latitude from -90 through 90.

Type number · GET query or POST JSON

Example / input hint: 30.2672

Requires lon and conflicts with location and uule.
Minimum: -90
Maximum: 90

lon

LongitudeOptional

Longitude from -180 through 180.

Type number · GET query or POST JSON

Example / input hint: -97.7431

Requires lat and conflicts with location and uule.
Minimum: -180
Maximum: 180

radius

Radius (meters)Optional

Decimal search-bias radius in meters.

Type number · GET query or POST JSON

Example / input hint: 150.75

Requires location or lat/lon.
Desktop: 1–199; tablet/mobile: 1–1,000.
Minimum: 1
Maximum: 1000

Knowledge Graph and layout controls

lsig

lsigOptional

Opaque Knowledge Graph or local-pack signature.

Type string · GET query or POST JSON

Maximum characters: 4096

si

siOptional

Opaque cached Google search context.

Type string · GET query or POST JSON

Maximum characters: 4096

ibp

ibpOptional

Google layout or expansion control.

Type string · GET query or POST JSON

Maximum characters: 4096

uds

udsOptional

Opaque Google filter token.

Type string · GET query or POST JSON

Maximum characters: 4096

color_scheme

Color schemeOptional

Google result color presentation.

Type string · GET query or POST JSON

Accepted valueslightdark

Localization, filtering, and pagination

google_domain

Google domainOptional

Results use google.com. Use gl, hl, cr, lr or geography for localization.

Type string · GET query or POST JSON · Default google.com

Example / input hint: google.com

gl

CountryOptional

Lowercase two-letter country localization code.

Type string · GET query or POST JSON

Example / input hint: us

Pattern: ^[a-z]{2}$

hl

LanguageOptional

Google interface and result language code.

Type string · GET query or POST JSON · Default en

Example / input hint: en

Pattern: ^[a-z]{2,3}(?:-[A-Za-z]{2,8})?$

cr

Country restrictOptional

One or more countryXX restrictions joined with |.

Type string · GET query or POST JSON

Example / input hint: countryUS

Pattern: ^country[A-Z]{2}(?:\|country[A-Z]{2})*$

lr

Language restrictOptional

One or more lang_xx restrictions joined with |.

Type string · GET query or POST JSON

Example / input hint: lang_en

Pattern: ^lang_[a-z]{2,3}(?:\|lang_[a-z]{2,3})*$

tbs

Search filterOptional

Google native date or search filter string.

Type string · GET query or POST JSON

Maximum characters: 4096

safe

Safe searchOptional

Google adult-content filtering.

Type string · GET query or POST JSON

Accepted valuesactiveoff

nfpr

Auto-correctionOptional

Google auto-correction control.

Type string · GET query or POST JSON

Accepted values01

filter

Similar resultsOptional

Google similar-result filtering control.

Type string · GET query or POST JSON

Accepted values01

pws

PersonalizationOptional

Google personalization control; 0 asks for non-personalized results.

Type string · GET query or POST JSON

Accepted values01

peek_pws

Personalization peekOptional

Google personalization peek flag, forwarded unchanged.

Type string · GET query or POST JSON

Accepted values01

tbm

VerticalOptional

Google vertical: lcl, vid, nws, shop, or pts. For image searches, use /api/google/images.

Type string · GET query or POST JSON

Example / input hint: nws

Accepted valueslclvidnwsshoppts

start

Start offsetOptional

Non-negative Google result offset.

Type integer · GET query or POST JSON · Default 0

Example / input hint: 0

Minimum: 0

device

DeviceOptional

Request device profile and radius bound.

Type string · GET query or POST JSON · Default desktop

Accepted valuesdesktoptabletmobile

Advanced query parameters

num

Results requestedOptional

Best-effort first-page result count, 1 to 10.

Type integer · GET query or POST JSON

Example / input hint: 10

Minimum: 1
Maximum: 10

as_dt

Site modeOptional

Includes or excludes as_sitesearch.

Type string · GET query or POST JSON

Accepted valuesie

Requires as_sitesearch.

as_epq

Exact phraseOptional

Exact phrase query.

Type string · GET query or POST JSON

Maximum characters: 2048

as_eq

Exclude phraseOptional

Excluded phrase query.

Type string · GET query or POST JSON

Maximum characters: 2048

as_lq

Links to URLOptional

Require results that link to this URL.

Type string · GET query or POST JSON

Example / input hint: https://example.com

Maximum characters: 4096

as_nlo

Range lowOptional

Inclusive range lower bound.

Type integer · GET query or POST JSON

Example / input hint: 10

Requires as_nhi.
Minimum: 0

as_nhi

Range highOptional

Inclusive range upper bound.

Type integer · GET query or POST JSON

Example / input hint: 100

Requires as_nlo.
Minimum: 0

as_oq

Any termsOptional

Any-of search terms.

Type string · GET query or POST JSON

Maximum characters: 2048

as_q

All termsOptional

Additional all-of search terms.

Type string · GET query or POST JSON

Maximum characters: 2048

as_qdr

Date rangeOptional

Quick range d, w, m, or y with an optional positive count.

Type string · GET query or POST JSON

Example / input hint: m3

Pattern: ^[dwmy](?:[1-9][0-9]*)?$

as_rq

Related to URLOptional

Find pages related to this URL.

Type string · GET query or POST JSON

Example / input hint: https://example.com

Maximum characters: 4096

as_sitesearch

Site hostnameOptional

Site hostname to include or exclude.

Type string · GET query or POST JSON

Example / input hint: example.com

Maximum characters: 253

Request context

Optional Google request context tokens. Omit them for a normal search.

oq

Original queryOptional

Original query associated with an autocomplete selection.

Type string · GET query or POST JSON

Maximum characters: 2048

gs_lp

Autocomplete lineageOptional

Google gs_lp value associated with an autocomplete selection.

Type string · GET query or POST JSON

Maximum characters: 4096

sclient

Search clientOptional

Google client identifier such as gws-wiz-serp.

Type string · GET query or POST JSON

Example / input hint: gws-wiz-serp

Maximum characters: 64
Pattern: ^[A-Za-z0-9._-]+$

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, search_information, organic_results, ads, ai_overview, answer_box, knowledge_graph, local_map, local_results, pagination, related_questions, related_searches, ask_ai_mode, available_on, broaden_searches, complementary_results, discover_more_places, discussions_and_forums, episode_guide, events_results, filters, flight_result, immersive_products, inline_images, inline_videos, jobs_results, news_results, perspectives, places_sites, recipes_results, refine_by, related_brands, related_categories, scholarly_articles, shopping_results, categorized_shopping_results, short_videos, sports_results, top_sights, top_stories, video_results, finance_results, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

{
  "search_metadata": {
    "id": "9e01884842ec2e3068eaf427",
    "status": "Success",
    "created_at": "2026-09-19 22:52:46 +00:00",
    "processed_at": "2026-09-19 22:52:54 +00:00",
    "total_time_taken": 8.24,
    "google_url": "https://www.google.com/search?q=What%20did%20Apple%20announce%20at%20WWDC%3F&hl=en&gl=us",
    "google_ai_overview_url": "https://www.google.com/search?q=What%20did%20Apple%20announce%20at%20WWDC%3F&hl=en&gl=us",
    "json_endpoint": "https://ecll-litescrape-v3--site-api-web.modal.run/api/google/ai-overview?device=desktop&gl=us&google_domain=google.com&hl=en&q=What+did+Apple+announce+at+WWDC%3F&start=0"
  },
  "search_parameters": {
    "q": "What did Apple announce at WWDC?",
    "device": "desktop",
    "google_domain": "google.com",
    "gl": "us",
    "hl": "en",
    "start": "0"
  },
  "ai_overview": {
    "text_blocks": [
      {
        "type": "paragraph",
        "snippet": "At Apple's WWDC 2026 keynote on June 8, 2026, Apple announced major AI integrations, new operating system previews, and a revamped Siri experience .",
        "snippet_highlighted_words": [
          "major AI integrations, new operating system previews, and a revamped Siri experience"
        ]
      },
      {
        "type": "heading",
        "snippet": "Major Software & AI Announcements"
      }
    ],
    "references": [
      {
        "link": "https://www.theshortcut.com/p/apple-wwdc-2026-liveblog-highlights",
        "source": "The Shortcut | Matt Swider",
        "index": 1
      },
      {
        "link": "https://www.popsci.com/gear/apple-wwdc-announcements-2026/",
        "source": "Popular Science",
        "index": 2
      }
    ]
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

Litescrape sells to AI agents - live prices and self-serve payment

Google AI Overview API

Integrate Google AI Overview

JSON POST request example

Google AI Overview parameters

Query and entity selectors

Geographic location

Knowledge Graph and layout controls

Localization, filtering, and pagination

Advanced query parameters

Request context

Work with the complete JSON response

More Google APIs