# The best Google AI Mode API. Every answer, every source.

> The conversational answer Google gives in AI Mode, with every page it cited in order. Captured in a real browser session, from any country, as clean JSON.

HTML page: https://www.honeyb.ai/platform/api/ai-mode-api

## What the API returns

Every path is on `https://app.honeyb.ai` and takes your key as a bearer token.

| Method | Path | What it does |
| --- | --- | --- |
| POST | `/api/platform/v1/tasks` | Submit a brand, up to 300 prompts and the engines to ask. |
| GET | `/api/platform/v1/tasks/{id}` | Task status, answers expected, completed and failed, and the settled cost. |
| GET | `/api/platform/v1/tasks/{id}/results` | One row per answer. |
| GET | `/api/platform/v1/tasks/{id}/citations` | One row per cited page. |

### Raw AI answers

- The answer text
- The cited sources
- Collection metadata: engine, country and time

| Field | What it holds |
| --- | --- |
| `prompt` | The question, exactly as it was asked. |
| `engine` | Which engine answered, as a stable slug: chatgpt, google_ai_overviews, google_ai_mode and the rest. |
| `answer` | The full answer text the app showed. |
| `createdAt` | When the answer was captured. |
| `url`, `domain`, `position` | Every source the answer cited, in the order it cited them, from the citations endpoint. |

### Enriched AI answers

- Everything in a raw answer
- Brands detected
- Competitors
- Sentiment
- Classified citations

| Field | What it holds |
| --- | --- |
| `brandMentions` | How many times the answer named your brand. |
| `competitorsMentioned` | Every other brand the answer named beside yours. |
| `sentiment` | The tone toward your brand: positive, neutral or negative. |
| `sentimentConfidence` | How sure that reading is, from 0 to 100. |
| `pageClassification` | What kind of page each source is: listicle, comparison, how-to, article, product page, category page, homepage or other. |

## Engines

Every engine is captured in a real browser session on the product people use, with memory and personalization off. Pass the slug in a task's `engines` list.

| Engine | Slug | Capture | Location |
| --- | --- | --- | --- |
| ChatGPT | `chatgpt` | Real browser session | Any country or US state |
| Google AI Overviews | `google_ai_overviews` | Real browser session | Any country |
| Google AI Mode | `google_ai_mode` | Real browser session | Any country |
| Gemini | `gemini` | Real browser session | Any country |
| Bing Copilot | `copilot` | Real browser session | Any country |
| Naver AI Briefing | `naver_ai_briefing` | Real browser session | Any country |
| Naver AI Mode | `naver_ai_mode` | Real browser session | Any country |
| ERNIE | `ernie` | Real browser session | Any country |
| Perplexity | `perplexity` | Real browser session | Any country |
| Claude | `claude` | Real browser session | Any country |
| Grok | `grok` | Real browser session | Any country |
| DeepSeek | `deepseek` | Real browser session | Any country |

## Prices per 1,000

US dollars per 1,000 delivered answers, from prepaid credits. No plan or subscription.

| Engine | Raw answers | Enriched answers |
| --- | --- | --- |
| ChatGPT | $1.05 | $2.05 |
| Google AI Overviews | $1.05 | $2.05 |
| Google AI Mode | $1.05 | $2.05 |
| Gemini | $1.05 | $2.05 |
| Bing Copilot | $1.05 | $2.05 |
| Naver AI Briefing | $1.05 | $2.05 |
| Naver AI Mode | $1.05 | $2.05 |
| ERNIE | $1.05 | $2.05 |
| Perplexity | $3.15 | $4.15 |
| Claude | $5.20 | $6.20 |
| Grok | $5.20 | $6.20 |
| DeepSeek | $5.20 | $6.20 |

Google rank checks: $1.00 per 1,000 checks. One check covers the top 10 results; a depth of 100 counts as ten checks.

One billable answer is one prompt on one engine, delivered. A failed capture is free, the price is held when you submit and settled to what arrived, and prepaid credits do not expire.

Prepaid credits, no plan or subscription. Credits never expire, and a failed answer is never charged.

## Quickstart

Submit a task, poll it until its status is `completed` or `failed`, then read the answers. The key is read from the `HONEYB_API_KEY` environment variable.

```bash
curl -X POST https://app.honeyb.ai/api/platform/v1/tasks \
  -H "Authorization: Bearer $HONEYB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": { "name": "Acme Billing", "url": "https://acmebilling.com" },
    "engines": ["google_ai_mode"],
    "prompts": ["What is the best billing platform for SaaS?"]
  }'

# Poll until "status" is "completed" or "failed", then read the answers
curl https://app.honeyb.ai/api/platform/v1/tasks/TASK_ID/results \
  -H "Authorization: Bearer $HONEYB_API_KEY"
```

A real response: the Google AI Mode answer to "best CRM for small businesses", captured in a real browser session in the United States, as `GET /tasks/{id}/results` and `/citations` return it, raw and shortened.

```json
{
  "prompt": "best CRM for small businesses",
  "engine": "google_ai_mode",
  "answer": "For most small businesses, ...",
  "citations": [
    { "position": 1, "domain": "reddit.com" },
    { "position": 2, "domain": "forbes.com" },
    { "position": 3, "domain": "uschamber.com" }
  ]
}
```

## MCP setup

The same key runs the MCP server at `https://platform.honeyb.ai/mcp` (Streamable HTTP), on the same credits and prices. Every config reads the key from an environment variable, so it never lands in a file, a commit or the chat.

Claude Code:

```bash
claude mcp add --transport http honeyb https://platform.honeyb.ai/mcp --scope project --header 'Authorization: Bearer ${HONEYB_API_KEY}'
```

Cursor, in `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "honeyb": {
      "url": "https://platform.honeyb.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:HONEYB_API_KEY}" }
    }
  }
}
```

Codex, in `~/.codex/config.toml`:

```toml
[mcp_servers.honeyb]
url = "https://platform.honeyb.ai/mcp"
bearer_token_env_var = "HONEYB_API_KEY"
```

Tools: `list_engines_and_prices`, `create_visibility_task`, `get_task`, `get_task_results`, `get_task_citations`, `create_rank_check`, `get_rank_check`, `get_rank_check_results`. Full setup: [MCP Server](https://www.honeyb.ai/platform/api/mcp.md).

## FAQ

### Is there an official Google AI Mode API?

No. Google publishes no endpoint that returns the AI Mode answer. Honeyb captures the AI Mode page in a real browser session for each prompt and returns the answer and every source it cited as JSON.

### Is it the real AI Mode?

Yes. Every answer is captured from Google's own AI Mode page in a real browser session, the page people see, never generated by a model API.

### How is AI Mode different from AI Overviews?

An AI Overview is a short answer above the results; AI Mode is a conversation on its own page, and it often names other brands and cites other pages for the same question. Both run on the same key: add google_ai_overviews beside google_ai_mode and every row carries the engine it came from.

### Which countries can I ask from?

Any country. Set the country on the task and the engine answers as a person there sees it.

### What is the difference between raw and enriched answers?

A raw answer is the answer itself with every source it cited, for $1.05 per 1,000. Enriched adds the brands detected, the competitors named beside yours, the sentiment and every source classified by page type, for $2.05 per 1,000.

### How is billing counted?

One billable answer is one prompt on one engine, delivered. A failed capture is free, the price is held when you submit and settled to what arrived, and prepaid credits never expire. AI Mode answers are $1.05 per 1,000 raw and $2.05 enriched.

### How do I get an API key?

Use Get your API key on this page. Tell us your engines and volume, and we issue the key within one working day. The same key runs AI Overviews, ChatGPT and every other engine.

## Get an API key

[Get your API key](https://www.honeyb.ai/platform/api/ai-mode-api) with the form on the page. We issue keys within one working day. Tell us your engines and volume.

## Every API page as Markdown

- [Honeyb API](https://www.honeyb.ai/platform/api.md): The AI search API: the answers AI engines show people, captured in real browser sessions, read into brands and sources, with Google rank checks on the same key.
- [API Pricing](https://www.honeyb.ai/platform/api/pricing.md): Every engine's price per 1,000 answers, raw and enriched, and the price of Google rank checks. Prepaid credits, no subscription.
- [LLM Scraper API](https://www.honeyb.ai/platform/api/llm-scraper-api.md): Ask every AI engine the same prompt and get each answer with every source it cited, in one call.
- [ChatGPT Scraper API](https://www.honeyb.ai/platform/api/chatgpt-scraper-api.md): The answer the ChatGPT app gives, with every source it cited, as JSON.
- [AI Overviews API](https://www.honeyb.ai/platform/api/ai-overviews-api.md): The AI Overview Google shows above the results, with every page it cited, as JSON.
- [Perplexity API](https://www.honeyb.ai/platform/api/perplexity-api.md): The answer Perplexity gives real people, with every source it cited, captured in a real browser session, as JSON.
- [AI Visibility API](https://www.honeyb.ai/platform/api/ai-visibility-api.md): Every AI answer read for you: the brands named, the competitors beside yours, the sentiment and every source classified.
- [AI Mentions API](https://www.honeyb.ai/platform/api/ai-mentions-api.md): Every AI answer that named a brand, with the engine, the prompt, the sentiment, the competitors and the sources.
- [Rank Tracking API](https://www.honeyb.ai/platform/api/rank-tracking-api.md): Google position, ranking URL and whether the AI Overview cites you, per keyword, on the same key as the AI answers.
- [MCP Server](https://www.honeyb.ai/platform/api/mcp.md): Every Honeyb API call as a tool for Claude Code, Cursor and Codex, on the same key and prices.
- [ChatGPT app vs its API](https://www.honeyb.ai/platform/api/chatgpt-app-vs-api.md): The same buying questions put to the ChatGPT app and its API cite different sources, measured side by side.
- [Backlinks API](https://www.honeyb.ai/platform/api/backlinks-api.md): Referring domains, backlinks, anchors and new or lost links for any domain or URL. Early access.
- [Keyword Data API](https://www.honeyb.ai/platform/api/keyword-data-api.md): Search volume, CPC, difficulty, keyword ideas and Google Trends for any market, plus AI prompt volume. Early access.
- [SERP API](https://www.honeyb.ai/platform/api/serp-api.md): Where a domain ranks on Google for any keyword, the URL and title shown, every SERP feature and whether the AI Overview cites it, any country down to a city.
