Google AI Mode API
Google's conversational AI Mode answer with citation pills, places, shopping cards, inline products, videos and ads.
Coming soon. The endpoint and fields below are the documented contract; requests are not accepted yet.
Price
4 credits per async request, 6 synchronous.
Endpoint
POST /v1/monitor/aimode
Request
curl -X POST "https://api.answerline.dev/v1/monitor/aimode" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"Family-friendly hotels in Lisbon","country":"PT","hl":"en"}' Request options
| Field | Type | Description |
|---|---|---|
prompt * | string | The prompt to send to AI Mode |
country | string | Country/region code for localized response |
gl | string | Alternative to `country`, using Google's own parameter name for the result geography. Same ISO 3166-1 alpha-2 codes, accepted in either case (`us` or `US`), and must be a country the endpoint supports — see `GET /v1/countries`. Provide `country` or `gl`; sending both with different values is a `400`. |
hl | string | Interface language, as Google's own `hl` parameter (e.g. `en`, `de`, `pt-BR`). Free-form and case-insensitive — Google owns the list of codes. Overrides the language answerline derives from the country, so the interface language and the result geography can differ. |
location | string | Google canonical location name for geo-targeted results, in comma-separated format: 'City,Region,Country' (see https://developers.google.com/google-ads/api/reference/data/geotargets for all ~100,000 supported locations). Use alongside 'country' for city-level precision. Mutually exclusive with 'uule' — provide one or the other, not both. |
uule | string | Pre-encoded Google UULE string for precise geo-targeting. Use this when you have a pre-built UULE value instead of a location name. Mutually exclusive with 'location' — provide one or the other, not both. |
device | "desktop" | "mobile" | Device type for search results |
include | object | Optional flags for including additional response formats |
include.html | boolean | Include a URL to the full HTML of the response |
include.markdown | boolean | Include markdown-formatted response in the result |
include.expandProducts | boolean | Fetch merchant offers for the product clusters in the response and return them as 'result.productResults'. Clusters are deduplicated across shopping cards and inline products, and expansion covers at most 6 per scrape. Charges +1 credit per cluster returned, to a maximum of +6. Off by default. |
include.googleGoto | boolean | Ignored since 8th September 2026. Every redirect link now ships as `redirectLink` beside its destination, so both are returned without this flag. Requests still sending it behave as if it were absent. |
What you get back
Field in result | Type | Description |
|---|---|---|
text | string | AI Mode's response text |
markdown | string | AI Mode's response formatted in Markdown (included when include.markdown is true) |
sources | object[] | Array of sources referenced in the response |
citationPills | object[] | Inline citation pills extracted from the AI Mode answer. Each entry is one (pill, source) pair: when a pill cites N sources (Google's `[Label +N]` chips), the array contains N entries sharing the same `citationPillId` but carrying per-source `label`, `url`, and `domain`. Group by `citationPillId` to recover the pill-level structure. Omitted from `result` when the answer carries no pills. |
places | object[] | Inline place cards extracted from the response |
shoppingCards | object[] | Shopping product information extracted from the response |
inlineProducts | object[] | Inline product cards found within the AI response text |
videos | object[] | Inline video cards embedded in the AI response (currently YouTube) |
map | object[] | GPS-enriched location data extracted from the response |
ads | object | Sponsored ad section extracted from the response |