# The best Perplexity API. The answer Perplexity users see, with every source.

> Every answer as Perplexity shows it to real people, with the sources it cited. Captured in a real browser session, from any country, as clean JSON. $3.15 per 1,000 answers.

HTML page: https://www.honeyb.ai/platform/api/perplexity-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": ["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 Perplexity answer to "best CRM for small businesses", captured in a real browser session (United States), as `GET /tasks/{id}/results` and `/citations` return it, raw and shortened.

```json
{
  "prompt": "best CRM for small businesses",
  "engine": "perplexity",
  "answer": "The right alternative depends ...",
  "citations": [
    { "position": 1, "domain": "pcmag.com" },
    { "position": 2, "domain": "bigin.com" },
    { "position": 3, "domain": "hubspot.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 Perplexity API?

Two things go by the name. Perplexity sells API access to its own models for building products. Honeyb's Perplexity API returns the answer the Perplexity app gives real people, with every source it cited, as JSON, so you see what your buyers read.

### Is it the real Perplexity?

Yes. Every answer is captured in a real browser session on Perplexity, the product people use, never generated through a model API.

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

Because the answer a person sees and the answer a model API returns 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 Perplexity too.

### Which countries can I ask from?

Any country. Set the country on the task and Perplexity 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 $3.15 per 1,000. Enriched adds the brands detected, the competitors named beside yours, the sentiment and every source classified by page type, for $4.15 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. Perplexity answers are $3.15 per 1,000 raw and $4.15 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 ChatGPT, Google AI and every other engine.

## Get an API key

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