Google AI Mode API reference

One endpoint, one key. It asks the question in Google’s AI Mode tab, signed out, and returns the answer a person would read and every source it links. See the Google AI Mode API: overview, pricing, and free tier.

Answer

GET /v1/google-ai-mode · 1 request

curl -G https://api.clair.im/v1/google-ai-mode \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=best project management software for small teams"

Parameter	Required	Contract
`q`	yes	The question, as a person would type it, up to 500 characters.
`country`	no	Two-letter country code the question is asked from, such as `us` or `gb`. Defaults to `us`.

AI Mode writes its answer for 10 to 30 seconds. Set your client timeout to 90 seconds.

{
  "engine": "google_ai_mode",
  "family": "ai",
  "query": {
    "q": "best project management software for small teams",
    "country": "us"
  },
  "answer": {
    "text": "The best project management tools for small teams focus on reducing administrative overhead, maximizing collaboration, and keeping workflows visible. Depending on your team's specific dynamic, technical background, and budget, the top tools group into distinct categories. 👥 The \"All-Rounder\" Industry Standards If you want a tool that can scale as you grow an\n...",
    "citations": [
      {
        "position": 1,
        "title": "Project management tool for a very small team with little tech experience",
        "url": "https://www.reddit.com/r/projectmanagement/comments/1vtl07f/project_management_tool_for_a_very_small_team/",
        "domain": "reddit.com"
      },
      {
        "position": 2,
        "title": "Best Project Management Software for Small Business (2026)",
        "url": "https://www.youtube.com/watch?v=Q1qUIaUDV5M&vl=en&t=479",
        "domain": "youtube.com"
      },
      {
        "position": 3,
        "title": "Best Project Management Software for Small Teams",
        "url": "https://www.youtube.com/watch?v=y30dYbckzfg&vl=en",
        "domain": "youtube.com"
      }
    ]
  }
}

Field	Contents
`answer.text`	The answer as the page shows it, a line per paragraph, heading, or list item.
`answer.citations`	The sources the answer links, in the order it shows them, each once: `position`, `title`, `url`, `domain`.

Answers change from one asking to the next, so nothing is cached. To measure visibility, ask each question several times and count how often a brand is named in text or its domain appears in citations.

What counts as a citation

A link to a source, in the answer or in the source list beside it, with Google’s redirect resolved to the page itself.
Not Google’s product cards: a product’s name linked to some page that mentions it. The product’s name is still in text.
Each URL once, in the order the answer first shows it.

Errors

A page that loads with no answer, after every scraping vendor has tried, is 502 scrape_failed; the request is not billed. A missing q, a q over 500 characters, or a country that is not two letters is 400.

What this API does not do

It does not ask follow-up questions in the same conversation.
It does not sign in, so it does not read answers personalized to an account.
It does not return ads, shopping cards, or images shown with an answer.

Auth, plans, rate limits, and error codes: Authentication.

ChatGPT

Google AI Overview

Google AI Mode

Google AI Mode API reference

Answer

What counts as a citation

Errors

What this API does not do

​Answer

​What counts as a citation

​Errors

​What this API does not do

Answer

What counts as a citation

Errors

What this API does not do