> ## Documentation Index
> Fetch the complete documentation index at: https://clair.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google AI Mode API reference

> Google AI Mode API: ask Google's AI Mode a question and get its answer and every source it cites, as JSON.

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](https://clair.im/apis/google-ai-mode).

## Answer

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

```sh theme={null}
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.

```json theme={null}
{
  "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](https://clair.im/docs/authentication.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.