> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhuntr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits and pricing

> How Huntr charges per request with no subscription.

Huntr uses **pay-per-request** billing. Add credits once, spend them across research and data endpoints. There is no monthly minimum.

## Check your balance

```bash theme={null}
curl https://api.tryhuntr.com/balance \
  -H "x-api-key: ${HUNTR_API_KEY}"
```

Top up via the [dashboard](https://tryhuntr.com/dashboard) or `POST /topup`.

## Public pricing matrix

```bash theme={null}
curl https://api.tryhuntr.com/pricing
```

This returns current prices for research tiers, models, and direct endpoints. **Use this as the source of truth** — do not hardcode prices in your integration.

## Research pricing

Each `POST /research` request charges **one displayed price** for the completed run:

| Tier       | What it unlocks                              |
| ---------- | -------------------------------------------- |
| `lite`     | Web search and page research                 |
| `standard` | + company enrichment (tech, contacts, pages) |
| `deep`     | + people enrichment, email finding, LinkedIn |

Optional `model` override adjusts price based on synthesis model cost.

Failed research requests are **not charged**. `422 BULK_ENRICHMENT_REQUIRED` responses are **not charged**.

## Direct endpoint pricing patterns

| Pattern         | Examples                                                                                            |
| --------------- | --------------------------------------------------------------------------------------------------- |
| Per result      | `/company-search`, `/person-search` — charged per row in the response                               |
| Per request     | `/company-tech-stack`, `/person-email`, `/page-scrape`, LinkedIn and X endpoints                    |
| Free previews   | `/company-search-count`, `/person-search-count`                                                     |
| Free when empty | Some endpoints charge `$0` when no billable data is found (see each operation in the API Reference) |

Every response includes `price` (USD for that call) and often `credits_remaining`.

## Starting credits

New accounts receive free credits after email verification — enough for many standard research requests. Exact amounts are shown in the dashboard and `/verify` response.

## Usage history

```bash theme={null}
curl "https://api.tryhuntr.com/usage?limit=20" \
  -H "x-api-key: ${HUNTR_API_KEY}"
```

## Design tips for cost control

1. **Preview list size** with count endpoints before paginating search.
2. **Use direct endpoints** when you only need one field.
3. **Reserve `/research`** for synthesis — not bulk enrichment.
4. **Call `/pricing`** in agent tooling so models pick the right tier.

## Next step

* [Quickstart](/quickstart)
* [Rate limits](/reference/rate-limits)
* [API Reference — Pricing](/api-reference)