Get Google AI Mode answer
litescrape.google.serp.ai_modeReturns the answer Google AI Mode generates for a question, as ordered text blocks, with the sources it cited
- Price
- $0.00015/successAt provider cost
- Success rate
- 50.6%Last 30 days · 1,745 calls
- Latency p50
- 8.5 sp95 34 s
- Last verified
- Sep 29, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.ai_mode?q=what+is+photosynthesis&gl=us&hl=enPreview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
q | string | Required | Question to ask, up to 2,048 characters. Required on every turn, including follow-ups. | what is the best espresso machine for a small kitchen |
gl | string | Optional | Two-letter country code used to localize results. | us |
hl | string | Optional | Language code such as en, en-GB, or de. | en |
uule | string | Optional | Pre-encoded Google location token. Mutually exclusive with location. | |
device | string | Optional | Google device layout. Each device is served Google's real layout for it. | |
timeout | number | Optional | 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. | |
location | string | Optional | Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule. | Austin, Texas |
image_url | string | Optional | 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. | |
continuable | boolean | Optional | Return a subsequent_request_token so this answer can be followed up, when Google offers a continuation. | |
google_domain | string | Optional | Google domain used for the request. | google.com |
subsequent_request_token | string | Optional | 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. | |
- Query parameters
qstringRequiredQuestion to ask, up to 2,048 characters. Required on every turn, including follow-ups.
Example:
what is the best espresso machine for a small kitchenglstringOptionalTwo-letter country code used to localize results.
Example:
ushlstringOptionalLanguage code such as en, en-GB, or de.
Example:
enuulestringOptionalPre-encoded Google location token. Mutually exclusive with location.
devicestringOptionalGoogle device layout. Each device is served Google's real layout for it.
timeoutnumberOptionalOptional 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.
locationstringOptionalHuman-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
Example:
Austin, Texasimage_urlstringOptionalPublic 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.
continuablebooleanOptionalReturn a subsequent_request_token so this answer can be followed up, when Google offers a continuation.
google_domainstringOptionalGoogle domain used for the request.
Example:
google.comsubsequent_request_tokenstringOptionalToken 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.
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.ai_mode?q=what+is+photosynthesis&gl=us&hl=en' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.google.serp.ai_mode?q=what+is+photosynthesis&gl=us&hl=en",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.google.serp.ai_mode?q=what+is+photosynthesis&gl=us&hl=en", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.00015/success, including the service fee.