Google Search

Google AI Mode

Send a prompt to Google's AI Mode and receive a structured conversational reply broken into ordered parts (paragraph, heading, list, images) with cited reference links. Each response includes a session_token: pass it on the next call to continue the conversation in context. Each call, including a follow-up, is billed as one request. The same endpoint also accepts POST with a JSON body for prompts that do not fit comfortably in a URL. In the rare case where Google returns no answer, the response is still 200 with an empty reply_parts array.

Price: $0.005 per request. Free tier: 50 requests/month.

get/v1/web/ai-mode

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/web/ai-mode
  • Auth: API key in header X-API-Key

Query parameters

promptstring required

The AI Mode prompt (max 12000 characters)

countrystring

2-letter ISO 3166-1 alpha-2 country code. A value that is not exactly 2 letters is rejected with 400.

languagestring

2-letter ISO 639-1 language code. A value that is not exactly 2 letters is rejected with 400.

session_tokenstring

Token from a previous AI Mode response. Pass it to continue the conversation with prior context. Treat as an opaque string.

Response

Successful response

session_tokenstring nullable

Changes

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