Google Search

Google AI Mode

Returns the answer Google AI Mode generates for a question, as ordered text blocks, with the sources it cited. Set continuable to receive a token for a follow-up question; each turn is billed as its own call. Answers take longer than other endpoints, so allow a client timeout of about 120 seconds.

get/api/google/ai-mode

Request

  • Base URL: https://api.litescrape.com
  • URL: https://api.litescrape.com/api/google/ai-mode
  • Auth: one of:
    • HTTP bearer
    • API key in header zc-signature

Query parameters

qstring required
Example:what is the best espresso machine for a small kitchen

Question to ask, up to 2,048 characters. Required on every turn, including follow-ups.

continuableboolean

Return a subsequent_request_token so this answer can be followed up, when Google offers a continuation.

subsequent_request_tokenstring

Token from a previous continuable response. Send it with a new q to continue that conversation; reuse the same gl, hl and location. Expires after 30 minutes. Cannot be combined with image_url.

image_urlstring

Public http or https URL of an image to include in the question, up to 2,048 characters. The image may be at most 20 MB. Cannot be combined with subsequent_request_token.

locationstring
Example:Austin, Texas

Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.

uulestring

Pre-encoded Google location token. Mutually exclusive with location.

google_domainstring
Example:google.com

Google domain used for the request.

glstring
Example:us

Two-letter country code used to localize results.

hlstring
Example:en

Language code such as en, en-GB, or de.

device'desktop' | 'tablet' | 'mobile'

Google device layout. Each device is served Google's real layout for it.

timeoutnumber

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.

Response

Successful response; one call consumed unless noted otherwise.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.