# Get Google AI Overview for a Query

> Get Google AI Overview for a Query is a paid API for AI agents from agents.litescrape.com, paid per call via MPP, $0.000150/call, status unknown (last checked 2026-09-18).

Fetches Google's AI-generated overview panel (text blocks with cited sources) for a given search query, returning 404 with no charge when Google produces no overview.

## Facts

- Endpoint: GET https://agents.litescrape.com/api/google/ai-overview
- Price: $0.000150/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Provider: agents.litescrape.com
- Website: https://agents.litescrape.com
- Canonical page: https://www.zero.xyz/c/agents-litescrape-com-get-google-ai-overview-for-a-query-bea60e09
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vSEGOc_5tc9tsNw78pE7h

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-litescrape-com-get-google-ai-overview-for-a-query-bea60e09
```

Example prompt: Can you pull Google's AI overview for the search query 'best treatments for lower back pain' and show me the summary text and all the sources it cites?

## When to prefer this

Choose this endpoint when you specifically need Google's AI-synthesized overview panel with cited sources, rather than a full set of organic search results. It is ideal when you want to understand what Google's generative AI says about a topic without processing full result pages. Use it over the standard search endpoint when the AI summary is the primary deliverable. Note that calling both this and the search endpoint for the same query counts as two separate Google requests.

## Known failure modes

- 404 not_found: Google did not generate an AI overview for this query — no charge applied
- Timeout: response may take up to 120 seconds; long waits can exceed client timeout thresholds
- Invalid query: missing q parameter when neither ludocid nor kgmid is supplied
- Conflicting location parameters: supplying both uule and location or lat/lon causes an error
- Rate or payment errors: insufficient balance or payment failure returns a 402 response
- Transient Google-side errors: Google may intermittently suppress overviews for certain queries

## How this service works

Runs the same Google Search contract as the search endpoint, waits for Google's overview generation window, and returns only search_metadata, search_parameters, and ai_overview (text blocks with snippets and the sources they cite). When Google generates no overview the response is 404 not_found and nothing is charged. Calling this and the search endpoint for the same query makes two independent Google requests. Allow up to 120 seconds for a response. One successful call is one request.

## Output

Returns a JSON object containing search_metadata (request ID, status, time taken), search_parameters (normalized inputs), and ai_overview (structured text_blocks with paragraph or list content and the source URLs/snippets each block cites). If Google generates no AI overview for the query, the endpoint returns a 404 not_found response and no charge is applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 2048,
   "description": "Search query. Required unless ludocid or kgmid is supplied."
  },
  "cr": {
   "type": "string",
   "description": "Country restrictions such as countryUS, joined with |."
  },
  "gl": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2,
   "description": "Two-letter country code for result localization, lowercase."
  },
  "hl": {
   "type": "string",
   "default": "en",
   "description": "Interface and result language code, such as en, en-GB, or de."
  },
  "lr": {
   "type": "string",
   "description": "Language restrictions such as lang_en, joined with |."
  },
  "oq": {
   "type": "string",
   "description": "Autocomplete original-query lineage value, forwarded verbatim."
  },
  "si": {
   "type": "string",
   "description": "Opaque cached Google search context from a previous response."
  },
  "ibp": {
   "type": "string",
   "description": "Google layout or expansion control token."
  },
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "description": "Latitude of the search origin. Requires lon; conflicts with location and uule."
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "description": "Longitude of the search origin. Requires lat; conflicts with location and uule."
  },
  "num": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Best-effort first-page result count, 1 to 100."
  },
  "tbm": {
   "enum": [
    "lcl",
    "vid",
    "nws",
    "shop",
    "pts"
   ],
   "type": "string",
   "description": "Google vertical: local, video, news, shopping, or patents. Images are not supported."
  },
  "tbs": {
   "type": "string",
   "description": "Google native date or search filter string."
  },
  "uds": {
   "type": "string",
   "description": "Opaque Google filter token from a previous response."
  },
  "as_q": {
   "type": "string",
   "description": "Additional all-of search terms."
  },
  "lsig": {
   "type": "string",
   "description": "Opaque Knowledge Graph or local-pack signature from a previous response."
  },
  "nfpr": {
   "enum": [
    "0",
    "1"
   ],
   "type": "string",
   "description": "Set 1 to exclude auto-corrected queries."
  },
  "safe": {
   "enum": [
    "active",
    "off"
   ],
   "type": "string",
   "description": "Adult-content filtering."
  },
  "uule": {
   "type": "string",
   "maxLength": 2048,
   "description": "Pre
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pagination": {
   "type": "object",
   "description": "Present when more results exist: next (a ready-made URL for the next page) or next_page_token."
  },
  "ai_overview": {
   "type": "object",
   "description": "Google's AI Overview: text_blocks with snippets and the sources they cite."
  },
  "search_metadata": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string"
    },
    "status": {
     "type": "string"
    },
    "total_time_taken": {
     "type": "number"
    }
   }
  },
  "search_parameters": {
   "type": "object",
   "description": "The request parameters as normalized by the API."
  }
 },
 "description": "Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-litescrape-com-get-google-ai-overview-for-a-query-bea60e09/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.litescrape.com](https://www.zero.xyz/host/agents.litescrape.com/llms.txt)