# The best LLM scraper API. Every engine's answer, in one call.

> Ask ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Bing Copilot and seven more engines the same question. Every answer comes back as people see it, with every source it cited, captured in real browser sessions.

HTML page: https://www.honeyb.ai/platform/api/llm-scraper-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. |

### Task limits

| Limit | Value |
| --- | --- |
| Prompts per task | Up to 300, each up to 500 characters; duplicates collapsed |
| Engines per task | Any of the twelve, one price on each |
| Competitors per task | Up to 10, always counted when named |
| Language | Any ISO 639-1 code; English by default |
| Time to answers | Seconds to a couple of minutes; rows appear as engines answer |
| Results kept | 30 days after submission; the task record and charge stay |
| Rate limit | 3,000 requests an hour per key, across every endpoint |
| Failed answers | Never charged; the hold is released at settlement |

## 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": ["chatgpt", "google_ai_overviews", "perplexity"],
    "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 ChatGPT 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": "chatgpt",
  "answer": "After researching the leading ...",
  "citations": [
    { "position": 1, "domain": "spotsaas.com" },
    { "position": 2, "domain": "stacknpilot.com" },
    { "position": 3, "domain": "itechguides.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

### What is an LLM scraper API?

An API that asks AI engines a prompt and returns each answer as data: the text, every source it cited and the engine it came from. Honeyb captures every engine in a real browser session, so each answer is the one people read.

### Why not call the model's API myself?

Because the app and its API cite different pages. Asked the same 5 buying questions at the same time, the ChatGPT app and OpenAI's API shared only 13% of cited sources: 24 of the app's 37 citations were reviews, guides and publishers, against 1 of the API's 109. The app is what your buyers read, so that is what Honeyb captures, on every engine.

### Which engines does it cover?

ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Bing Copilot, Naver AI Briefing, Naver AI Mode, ERNIE, Perplexity, Claude, Grok and DeepSeek. Every one is captured in a real browser session, on one task and one key.

### Which countries can I ask from?

Any country. Set the country on the task and each engine answers as a person there sees it. ChatGPT can also answer as a user in a chosen US state.

### 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. Raw answers are $1.05 per 1,000 and enriched answers $2.05.

### Can I get the brands and sentiment too?

Yes. Ask for enriched answers and each comes back with the brands detected, the competitors named beside yours, the sentiment and every source classified by page type, for $2.05 per 1,000.

### 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 the REST API and the MCP server.

## Get an API key

[Get your API key](https://www.honeyb.ai/platform/api/llm-scraper-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.
- [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.
- [Google AI Mode API](https://www.honeyb.ai/platform/api/ai-mode-api.md): The answer Google AI Mode gives, with every source it cited in order, 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.
