# Credits & Billing

> How the HushSearch credit system works.

Source: http://localhost:3000/docs/getting-started/credits

HushSearch uses a pay-as-you-go credit system. Credits never expire.

## Credit Costs

Authoritative costs (same as `GET /v1/trust/economics` and `docs/economics.md`):

| Endpoint | Credits per Call |
|---|---|
| `/v1/search/` | 1 |
| `/v1/scrape/` | 2 |
| `/v1/extract/` | 3 |
| `/v1/crawl/` | 3 |
| `/v1/search-and-summarize/` | 5 |
| `/v1/research/` | 8 |
| `/v1/screenshot/` | 3 |
| job: crawl (async) | 5 |

## Credit Packs

| Pack | Credits | Price | Per 1k calls |
|---|---|---|---|
| Free | 500 | $0 | — |
| Starter | 12,000 | $10 | $0.83 |
| Growth | 65,000 | $50 | $0.77 |
| Pro | 140,000 | $100 | $0.71 |

## Rate limits

Free tier: **100 requests/day** (see [Rate Limits](http://localhost:3000/docs/getting-started/rate-limits)). Paid tiers have higher daily caps; there is no claim of unlimited free traffic.

## What Happens When Credits Run Out?

The API returns a `402 Payment Required` response:

```json
{
  "detail": "Insufficient credits. Top up at the billing dashboard."
}
```

Credits are deducted atomically — you're never charged for failed requests (auth failures, network errors, upstream timeouts).
