Credits & pricing
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 /endpointsandGET /openapi.jsonnever cost credits. In the MCP server, searching endpoints, reading schemas andget_accountare free too.
Which endpoints cost what
Section titled “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 (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_endpointsresults.
Pagination and cost
Section titled “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.
Check your balance
Section titled “Check your balance”GET /me is free and returns your balance:
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.
Out of credits: 402
Section titled “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:
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Retrying won’t help. Top up first.
Plans and top-ups
Section titled “Plans and top-ups”Plans and credit packs are in the dashboard under Billing.