Skip to content

New AI assistant answers: ChatGPT, Gemini, Copilot and AI Mode by API

SerpKite
Get API key

POST /v1/ai_mode

Google AI Mode API

Get Google AI Mode's answer, the conversational search tab (udm=50), for any prompt: the answer, the sources it cited, and whether it named or cited your brand.

Updated

Get a free API key Try it in the dashboard
2 credits per answer (5–45 s), the same in batches 2,500 free credits, no card Failed calls are free

Overview

What the Google AI Mode API does

POST /v1/ai_mode asks Google AI Mode as a logged-out visitor and returns the answer as text and markdown with [n](link) citations, the sources it cited, and products where Google shows them.

AI Mode answers for one country at a time: country is the country Google answers for, and we ask as a visitor there. Short informational answers take 5 to 10 seconds; long commercial ones up to about 45.

track adds mentions for up to 20 brands and domains. For the AI Overview at the top of a normal results page, use /v1/search: its ai_overview field is included in the search price.

What you get

request object
The normalised request: endpoint, prompt, country, language (not chatgpt), location and uule (ai_mode and brave_ai, when sent), web_search (chatgpt), include_html.
text string
The answer as plain text.
markdown string
The answer as Markdown. Citations are n, where n is the position of a source in sources.
html string
The answer's HTML, only with include_html: true.
model string
The model the assistant reports to logged-out visitors, when it reports one.
sources[] array
position (the n in the citations), title, link, domain, snippet, date, cited (true: cited inline in the answer; false: only listed beside it).
search_queries[] array
The searches the assistant ran to answer (its fan-out), where it shows them.
products[] array
Product cards shown with the answer: position, title, brand, price (as shown), extracted_price, currency (ISO 4217 when unambiguous), rating, reviews, merchant, link, image, description.
places[] array
Local businesses the answer showed, same shape as /v1/maps results.
related_questions[] array
Follow-up questions the assistant suggested.
mentions[] array
Only with track, one per term: term, mentioned (the answer text names it), cited (a cited source matches it), sources (positions of matching sources, cited or listed), products (positions of matching products), text_position (where the text first names it, 0 = start to 1 = end; -1 when it doesn't). See AI visibility tracking.
meta object
request_id, credits_used, cached, cached_at, engine (the assistant), latency_ms, parse_quality.

Request

curl https://api.serpkite.com/v1/ai_mode \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"how to remove a red wine stain from a wool carpet"}'

Response (illustrative; answers vary from run to run)

200 OK · application/json
{
  "request": {
    "endpoint": "ai_mode",
    "prompt": "how to remove a red wine stain from a wool carpet",
    "country": "us",
    "language": "en"
  },
  "text": "Blot (don't rub) as much wine as you can, then dab the stain with cold water and a little wool-safe detergent…",
  "markdown": "**Blot, don't rub**, as much wine as you can, then dab the stain with cold water and a little wool-safe detergent [1](https://www.example.com/wool-carpet-stains)…",
  "sources": [
    {
      "position": 1,
      "title": "Cleaning wool carpets: stains",
      "link": "https://www.example.com/wool-carpet-stains",
      "domain": "example.com",
      "cited": true
    },
    {
      "position": 2,
      "title": "How to get red wine out of carpet",
      "link": "https://www.example.org/red-wine-carpet",
      "domain": "example.org",
      "cited": false
    }
  ],
  "search_queries": [],
  "products": [],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 3,
    "cached": false,
    "engine": "ai_mode",
    "latency_ms": 9800,
    "parse_quality": "ok"
  }
}

Every response also carries X-Credits-Used, X-Credits-Remaining, X-Cache and X-Tokens-Estimate headers. Full endpoint reference

Measured Oct 28, 2026

How Google AI Mode API behaves on this endpoint

Logged-out AI Mode prompts (informational and commercial) asked for several countries.

Answered
When the visitor is in the country asked for, so every prompt is asked from the country you send
Time to full answer
5–10 s for informational prompts, about 40 s for commercial ones
Eligibility
Google offers AI Mode only to some visitors; an answer it doesn't give is not billed

Filters and limits

  • prompt up to 4,000 characters; one turn per request.
  • country is the country Google answers for; language the interface language.
  • Product cards were rare in our tests outside the US.

AI visibility

Is your brand in the answer?

  • track takes up to 20 brands ("Pipedrive") and domains ("hubspot.com", subdomains match).
  • Each comes back in mentions: named in the text, cited, the matching sources and products, and how early it's named (text_position, 0 to 1).
  • A monitor asks the prompt hourly, daily or weekly and reports every answer with its mentions and new_sources, to a signed webhook. Each run costs 2 credits.
  • Answers vary between runs: ask each prompt several times and track how often you're named. AI visibility guide
mentions (illustrative)
{
  "mentions": [
    {"term": "hubspot.com", "mentioned": true, "cited": true, "sources": [2,5], "products": [], "text_position": 0.08},
    {"term": "Pipedrive", "mentioned": true, "cited": false, "sources": [], "products": [], "text_position": 0.41},
    {"term": "Acme CRM", "mentioned": false, "cited": false, "sources": [], "products": [], "text_position": -1}
  ]
}
curl https://api.serpkite.com/v1/monitors \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"ai_mode","prompt":"What are the best CRMs for a 10-person startup?","track":["hubspot.com","Pipedrive","Acme CRM"],"interval":"daily","webhook_url":"https://example.com/hooks/serpkite"}'

Reference

Parameters

The fields /v1/ai_mode accepts in its JSON body.

Google AI Mode API parameters
Name Type Default Description
prompt required string – The message to the assistant, up to 4,000 characters. Required. (q is not accepted here.)
country string – The country Google answers for (ISO 3166-1 alpha-2). AI Mode is asked from that country.
language string en Interface language (e.g. en, de). The answer follows the prompt's language.
location string – The city the answer is for, e.g. "Austin, Texas, United States" (up to 256 characters): local prompts ("best pizza near me") answer for that place. country defaults to its country. Use the "City, Region, Country" form: Brave returns 400 (free) for a place it can't find, and AI Mode answers for the area our request comes from when Google doesn't know the name. uule (Google's encoded location) works the same way.
track string[] – Up to 20 brands ("Acme") or domains ("acme.com", subdomains match), 100 characters each, to check the answer for. Each comes back in mentions. A term with a dot is a domain: it matches sources and product links on that domain; other terms match whole words, case-insensitively.
include_html boolean false Also return the answer's HTML in html.
format string json markdown returns the answer, its sources, searches, products and a Mentions section as one Markdown document; compact keeps text, sources (n, title, link), search_queries, products and places. Values: json, markdown, compact.
fields string – Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
max_age integer – Accept a cached answer up to this many seconds old, at half price. Answers are cached for at most 1 hour, and only a request with max_age reads the cache.

Full reference, error codes and headers are in the /v1/ai_mode reference. Queue up to 100 prompts with POST /v1/batches, at the same price per answer.

Use cases

What people build with the Google AI Mode API

01

AI visibility (GEO) tracking

Ask the prompts your buyers ask and see whether the answer names you, cites your domain or lists your product.

02

Share of answer over time

A monitor asks the same prompt hourly, daily or weekly and reports every answer with its mentions and new sources.

03

Citation research

Find which pages and domains the assistant cites for your category, then fix or pitch the ones that matter.

04

Agent tool

Give an agent a second opinion from a public assistant through the MCP tool or one SDK call.

Pricing

Google AI Mode API pricing

Cost per call

2 credits

per answer (5–45 s), the same in batches

  • From $1.20 per 1,000 answers at volume.
  • Credits never expire. No subscription.
  • Failed, empty and blocked calls are refunded.
  • 2,500 free credits = 1,250 answers, then 1,000 credits a month.
See all pricing
Google AI Mode API cost per pack
Pack Price Per 1k credits Per 1k answers Answers per pack
Starter $10 $1.00 $2.00 5,000
Growth $50 $0.80 $1.60 31,250
Pro $300 $0.60 $1.20 250,000

Google AI Mode answers cost 2 credits: $2.00 → $1.20 per 1,000 answers, from packs whose credits never expire. For reference, cloro.dev lists AI Mode at 4 credits per request on plans from $0.31 to $0.80 per 1,000 credits (checked 2026-10-28).

FAQ

Google AI Mode API: common questions

Start building

Start with the Google AI Mode API

2,500 free credits, then 1,000 every month. No credit card.