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

# Credits

> How the Prefetch API credit system works, including costs per endpoint and billing behavior.

## Credit costs

Each data extraction endpoint consumes a fixed number of credits per successful request:

| Endpoint          | Credits | What you get                               |
| ----------------- | ------- | ------------------------------------------ |
| `GET /enrich`     | 20      | Brand + company + classification           |
| `GET /brand`      | 10      | Colors, logos, fonts, social links         |
| `GET /company`    | 5       | Company name, emails, addresses            |
| `GET /classify`   | 5       | IAB category, descriptions, tickers, ISINs |
| `GET /screenshot` | 2       | Webpage screenshot URL                     |
| `GET /health`     | —       | Liveness check                             |
| `GET /ready`      | —       | Readiness check                            |

## When credits are deducted

Credits are deducted **only on successful responses** — meaning the API returned `"success": true` with a `200` status code.

You are **not charged** for:

* Failed requests (4xx or 5xx responses)
* Validation errors (missing URL, bad parameters)
* Authentication failures
* Rate limit rejections (429)
* Timeouts (504)

## Credit limits

Each API key can have a `credits_limit` configured. When cumulative `credits_used` reaches this limit, all further requests return:

```json theme={null}
{
  "success": false,
  "error": "Credit limit exceeded",
  "meta": { ... }
}
```

Manage and monitor your credit usage from the [dashboard](https://dashboard.prefetch.io).

## Choosing the right endpoint

When you need brand, company, and classification data for a URL, use `/enrich` for a single optimised call instead of three separate requests:

<Columns cols={2}>
  <Card title="Use /enrich" icon="layer-group">
    20 credits for brand + company + classification.

    Best when you want a complete domain profile in one call.
  </Card>

  <Card title="Use individual endpoints" icon="split">
    More targeted — only pay for what you need.

    Best when you only need one or two data types.
  </Card>
</Columns>

| Scenario                    | Best approach          | Credits spent |
| --------------------------- | ---------------------- | ------------- |
| Need all three data types   | `/enrich`              | 20            |
| Need brand + company only   | `/brand` + `/company`  | 15            |
| Need brand only             | `/brand`               | 10            |
| Need classification only    | `/classify`            | 5             |
| Need screenshot only        | `/screenshot`          | 2             |
| Need brand + classification | `/brand` + `/classify` | 15            |