> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# Credits & pricing

Each successful call costs the endpoint's cost_credit, however many results it returns; failed calls are free.

Scrapier bills in credits. The rule is short:

- **A successful call costs the endpoint's `cost_credit`.** Most endpoints cost 1 credit; heavier ones cost more (up to 3). The price is shown on every endpoint page.
- **The price is per call, not per result.** A page with 100 items and a page with 3 cost the same. An empty page still costs the endpoint's `cost_credit`.
- **Failed calls are free.** Any non-2xx response (bad input, bad key, timeouts, upstream errors) is not charged.
- **Discovery is free:** `GET /me`, `GET /endpoints` and `GET /openapi.json` never cost credits. In the [MCP server](https://docs.scrapier.io/ai/mcp.md), searching endpoints, reading schemas and `get_account` are free too.

## Which endpoints cost what

Every endpoint shows its own price, so you never have to work it out:

- on its page in the [API reference](https://docs.scrapier.io/api-reference.md) (the badge under the title);
- in the **Credits** column of [All platforms](https://docs.scrapier.io/api-reference.md) and each platform's endpoint table;
- in the live catalog as `cost_credit` (see [Discovery endpoints](https://docs.scrapier.io/discovery.md));
- in the MCP server's `search_endpoints` results.

## Pagination and cost

Each page is a separate call billed at the endpoint's price, so fetching 5 pages of a 2-credit endpoint costs 10 credits, and 5 pages of a 1-credit endpoint costs 5. When you loop over pages, cap the number of pages you fetch. See [Pagination](https://docs.scrapier.io/pagination.md).

## Check your balance

`GET /me` is free and returns your balance:

```bash
curl "https://api.scrapier.io/api/v2/me" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json
{ "credits": { "balance": 9871 }, "plan": "Pro" }
```

Some fields are left out if they can't be looked up, and `plan` is missing if you have no active subscription. Your call history is at [app.scrapier.io/dashboard/history](https://app.scrapier.io/dashboard/history) and usage at [app.scrapier.io/dashboard/usage](https://app.scrapier.io/dashboard/usage).

## Out of credits: 402

A scrape needs at least the endpoint's price in your balance. With less, you get **HTTP 402** before anything runs:

```json
{
  "error": "Insufficient credits. Buy more to scrape more.",
  "balance": 1,
  "required": 2
}
```

Retrying won't help. Top up first.

> **A 402 without balance is not about your credits:** A target platform's own error can occasionally come back as a 402. If the body has no `balance` field, it didn't come from billing. Treat it like a server error and retry later. See [Errors](https://docs.scrapier.io/errors.md#402).

## Plans and top-ups

Plans and credit packs are in the dashboard under [Billing](https://app.scrapier.io/dashboard/billing).
