# Keyword data API, with prompt volume for the AI side.

> Search volume, CPC and competition for up to 1,000 keywords per batch in any market, difficulty and keyword ideas in bulk, Google Trends, and how often a question is asked to AI engines.

Early access. The endpoints below are the launch contract; request access to be on it first, and use the AI answer endpoints now. AI answers: [LLM Scraper API](https://www.honeyb.ai/platform/api/llm-scraper-api.md).

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

## What the API returns

Monthly Google search volume with a twelve-month trend, CPC and competition for any country and language. Difficulty from 0 to 100 comes from its own endpoint. Keyword ideas and related terms come from seed keywords or a domain, with volume, CPC, difficulty and intent per row. Prompt volume reports how often a question is asked to AI engines, so a content plan can be sized for both surfaces.

**Ideas from a seed or a domain.** Expand up to 20 seed keywords, or start from a domain, with volume, CPC, difficulty and intent on every row.

**Difficulty in bulk.** A 0 to 100 score for up to 1,000 keywords per batch.

**Trends.** Interest over time and related queries for up to five keywords per request.

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/keywords/volume` | Monthly Google search volume, CPC, competition and a twelve-month trend for up to 1,000 keywords per batch. |
| POST | `/api/platform/v1/keywords/ideas` | Keyword ideas and related terms from seed keywords or a domain, with volume, CPC, difficulty and intent per row. |
| POST | `/api/platform/v1/keywords/difficulty` | Difficulty from 0 to 100 for up to 1,000 keywords per batch. |
| POST | `/api/platform/v1/keywords/prompt-volume` | How often a question is asked to AI engines, for up to 1,000 prompts per batch. |
| POST | `/api/platform/v1/keywords/trends` | Interest over time and related queries for up to five keywords per request. |

## 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 | $5.20 | $6.20 |
| 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.

Search volume is $0.20 per batch of up to 1,000 keywords. Difficulty, ideas and prompt volume are $0.025 per request plus $0.25 per 1,000 keywords, rows or prompts. Google Trends is $0.02 per request. All from a credit balance of prepaid credits. No subscription.

## Quickstart

### AI answers, on the same key

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 a keyword research API?

An API that returns search volume, cost per click, competition, difficulty and related keyword ideas for any keyword in any market, so a product or a team can do keyword research programmatically instead of through a tool's interface.

### What does the volume endpoint return?

Monthly Google search volume, CPC, competition and a twelve-month trend for up to 1,000 keywords per batch, for any country and language. Difficulty has its own endpoint.

### What is prompt volume?

An estimate of how often a question is asked to AI engines, returned for up to 1,000 prompts per batch, so content can be planned for AI answers as well as search.

### Can I get keyword ideas from a competitor's domain?

Yes. The ideas endpoint takes seed keywords or a domain and returns ideas and related terms with volume, CPC, difficulty and intent per row.

### Does the API return keyword difficulty in bulk?

Yes. The difficulty endpoint accepts up to 1,000 keywords per batch and returns a score from 0 to 100.

### How is the keyword data API priced?

$0.20 per batch of up to 1,000 keywords for search volume; $0.025 per request plus $0.25 per 1,000 rows for difficulty, ideas and prompt volume; $0.02 per Trends request. Prepaid credits, no subscription.

## Get an API key

[Request early access](https://www.honeyb.ai/platform/api/keyword-data-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.
- [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.
- [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.
