Google

Google AI Mode API

Retrieve Google AI Mode answers, with optional image questions and encrypted client-carried follow-up conversations.

Try in the request builder API reference Connect with MCP

Make a request

Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.

POST /v1/google/ai-mode

curl 'https://api.prismcrawl.com/v1/google/ai-mode' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "query": "how do solar panels work"
}'

Supported parameters

Parameter	Usage
`query`Required	Text to search for on the selected service.
`country`	Two-letter country or storefront code, such as us or gb.
`language`	Provider-supported language code, such as en.
`device`	Device presentation for the source request. desktop, mobile, tablet
`html`	Return the encoded original response rather than parsed JSON.
`zero_trace`	Do not archive source or parsed response artifacts.
`location`	Location to search around, such as Austin, TX.
`coordinates`	Latitude and longitude for location targeting.
`uule`	Encoded Google location; cannot be combined with location or coordinates.
`image_url`	Public HTTPS image URL for an initial or follow-up question.
`continuable`	Return an encrypted, account-bound conversation token. Starts with a dedicated unbanked session; expires 15 minutes after the first request.
`subsequent_request_token`	Token returned by this endpoint. Send a new query, optionally an image, and keep the original locale/location. Requires no backend conversation storage. Google may expire the conversation sooner.

Structured results

Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.

addresscategorycoordinatesdescriptionidlatitudelinkslongitudenamephonepositionrankratingrating_maxrating_sourcereview_countsnippettextthumbnailtitletypeurlwebsite

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.

Python SDK: pip install prismcrawl
Node.js SDK: npm install prismcrawl