Skip to content

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, searching endpoints, reading schemas and get_account are free too.

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

  • on its page in the API reference (the badge under the title);
  • in the Credits column of All platforms and each platform’s endpoint table;
  • in the live catalog as cost_credit (see Discovery endpoints);
  • in the MCP server’s search_endpoints results.

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.

GET /me is free and returns your balance:

Terminal window
curl "https://api.scrapier.io/api/v2/me" \
-H "X-API-Key: YOUR_API_KEY"
{ "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 and usage at app.scrapier.io/dashboard/usage.

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

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

Retrying won’t help. Top up first.

Plans and credit packs are in the dashboard under Billing.