SerpBase

API reference · Search engines

Google AI Mode

Google's AI Mode answer to a question, as plain text and as Markdown with its headings, lists and tables, plus the pages it cites with their real URLs.

POSThttps://api.serpbase.dev/google/ai_mode
1 credit until 2026-11-26 16:00 UTC, then 3 creditsOpen in Playground

Example

BASH
curl -X POST 'https://api.serpbase.dev/google/ai_mode' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  --max-time 60 \
  -d '{"gl":"us","hl":"en","q":"how does a heat pump work"}'

No recorded response is published for this endpoint yet. Run the example in the Playground to see a live one.

Parameters

format
"json" | "markdown"
json (default) returns the parsed result.
More

markdown returns the same result as Markdown text (text/markdown) for language models: no envelope, no duplicate alias fields, no inline images. Same credits; failures keep the JSON envelope.

gl
string
Example: "us"
hl
string
Example: "en"
q
string
Example: "how does a heat pump work"

The sample shows example parameters, not the complete request contract. Known fields are validated by the API; additional parameters are allowed.

What comes back

The fields are those in the response above; every endpoint also carries status, credits_charged and request_id.

If it fails

A failed request has a non-zero status and an error, and is not charged. The ones you will see here:

1000A parameter is missing or wrongFix the request
1020No credits leftTop up
1029Over your requests per secondWait Retry-After seconds
1502 · 1504The source could not be read this timeRetry
All status codes →