# The backlinks API for any domain.

> A link summary for any domain or URL, and the backlink rows behind it: referring domains, anchors, and new or lost links, up to 1,000 rows per request. Usage-based, no subscription.

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/backlinks-api

## What the API returns

The summary returns referring domains, backlinks, rank, dofollow share and the 30-day new and lost counts for any domain or URL. The list endpoint returns the rows behind it: backlinks, referring domains, anchors, and new or lost links, up to 1,000 rows per request.

**Any target.** A domain, a subdomain or a single URL, yours or anyone else's.

**Filters and a cursor.** Filter the rows and page through large profiles with a cursor, 1,000 rows at a time.

**New and lost.** The summary carries 30-day new and lost counts; the list returns the new or lost links themselves.

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

| Method | Path | What it does |
| --- | --- | --- |
| GET | `/api/platform/v1/backlinks/summary` | Referring domains, backlinks, rank, dofollow share and 30-day new and lost counts. |
| GET | `/api/platform/v1/backlinks/list` | Backlinks, referring domains, anchors, and new or lost links, up to 1,000 rows per request with filters and a cursor. |

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

A summary call is $0.06. The list endpoint is $0.06 per request plus $0.10 per 1,000 rows returned. 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 backlinks API?

An API that returns the links pointing at a domain, the domains they come from, the anchor text used and how the profile changes, as structured data. It lets a product or an agency run link audits, prospecting and reporting without a manual tool.

### Can I check backlinks for any domain, including competitors?

Yes. The endpoints take any domain, subdomain or URL. No site verification is needed.

### What does the summary return?

Referring domains, backlinks, rank, dofollow share and the counts of referring domains gained and lost over the last 30 days.

### How many rows can I fetch?

Up to 1,000 rows per list request, with filters and a cursor to page through larger profiles.

### When does the backlinks API open?

It is in early access. The endpoints above are the launch contract; request access to be on it first.

### How is the backlinks API priced?

$0.06 per summary call, and $0.06 per request plus $0.10 per 1,000 rows for the list endpoint, from a credit balance of prepaid credits. No subscription.

## Get an API key

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