# The best rank tracking API. Your Google rank and the AI Overview citation, in one check.

> Google position, ranking URL and whether the AI Overview cites you, for up to 1,000 keywords a check. The same keywords run on twelve AI engines, on the same key.

HTML page: https://www.honeyb.ai/platform/api/rank-tracking-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/rank/check` | Google: submit a domain and up to 1,000 keywords with location, language, device and depth 10 or 100. $1.00 per 1,000 checks. |
| POST | `/api/platform/v1/tasks` | AI engines: submit a brand, the same keywords phrased as prompts (up to 300) and the engines to ask. Enriched answers from $2.05 per 1,000. |
| GET | `/api/platform/v1/rank/check/{id}` | The check with running keyword counts: running, completed or failed, and the settled cost. |
| GET | `/api/platform/v1/rank/check/{id}/results` | One row per keyword: position, absolute position, ranking URL and title, SERP features and the AI Overview citation. |
| GET | `/api/platform/v1/tasks/{id}/results` | One row per answer: engine, prompt, answer text, brand mentions, competitors named and sentiment. |
| GET | `/api/platform/v1/tasks/{id}/citations` | Every page the AI engines cited, with domain, page type and its place in the source list. |

### 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. |

### Google rank checks

Returns one row per keyword: position, ranking URL and title, SERP features and whether the AI Overview cited the domain.

| Limit | Value |
| --- | --- |
| Keywords per check | Up to 1,000, each up to 200 characters |
| Search engine | Google |
| Depth | 10 results (one check) or 100 (ten checks) |
| Market | A location code (2840 is the United States) and a language tag |
| Device | Desktop or mobile |
| Time to results | About five minutes; poll every 30 to 60 seconds |
| Results kept | 30 days after submission |
| Rate limit | 3,000 requests an hour per key, across every endpoint |
| Unmeasured keywords | Free: no results page or an upstream failure is never billed |

## 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.

Prepaid credits, no plan or subscription. A keyword with no results page is never charged.

## Quickstart

### Google rank checks

Submit a check, poll it every 30 to 60 seconds, then read one row per keyword.

```bash
curl -X POST https://app.honeyb.ai/api/platform/v1/rank/check \
  -H "Authorization: Bearer $HONEYB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "zoho.com",
    "keywords": ["best CRM for small businesses", "best project management software for remote teams"],
    "location_code": 2840,
    "language_code": "en",
    "device": "desktop",
    "depth": 10
  }'

# Poll every 30 to 60 seconds until "status" is "completed" or "failed"
curl https://app.honeyb.ai/api/platform/v1/rank/check/CHECK_ID/results?pageSize=1000 \
  -H "Authorization: Bearer $HONEYB_API_KEY"
```

A real result row for zoho.com on "best CRM for small businesses", read from Google's own results page in the United States.

```json
{
  "keyword": "best CRM for small businesses",
  "position": 6,
  "absolutePosition": 7,
  "url": "https://www.zoho.com/crm/small-business-crm-software/",
  "serpFeatures": [
    "ai_overview",
    "people_also_ask",
    "related_searches"
  ],
  "aiOverview": {
    "present": true,
    "cited": true,
    "citedUrls": [
      "https://www.zoho.com/crm"
    ]
  }
}
```

### AI answers on the same keywords

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 rank tracking API?

An API that checks where a domain ranks on Google for a list of keywords and returns the position, the ranking URL, the SERP features and whether the AI Overview cited it. Honeyb runs the same keywords on twelve AI engines with the same key, so Google and AI answers sit side by side.

### Which engines does it cover?

Google for rank checks, and ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Bing Copilot, Naver AI Briefing, Naver AI Mode, ERNIE, Perplexity, Claude, Grok and DeepSeek for AI answers, every one captured in a real browser session.

### Can I check rankings by location or device?

Yes. Every check takes a location code (2840 is the United States), a language tag, and desktop or mobile.

### How many keywords can one check hold?

Up to 1,000. Results arrive in about five minutes, one row per keyword.

### Does it return the AI Overview?

Yes. Every keyword reports whether an AI Overview appeared, whether it cited your domain and which of your URLs it cited, next to your Google position.

### How is it priced?

$1 per 1,000 checks at a depth of 10; a depth of 100 counts as ten checks. A keyword with no results page or an upstream failure is never billed. AI answers on the same keywords 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 rank checks, AI answers and the MCP server.

## Get an API key

[Get your API key](https://www.honeyb.ai/platform/api/rank-tracking-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.
- [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.
