Plans and costs
Every plan, plus the credit cost of every endpoint.
This is the authoritative price list — the same table that meters requests — so a caller can cost a workload before spending anything on it. GET /v1 carries the same per-endpoint costs. Free.
Request
https://api.scrapercompany.com/v1/billing/plansAuthenticate with your API key in the x-api-key header (see Authentication).
Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.
Example request
curl "https://api.scrapercompany.com/v1/billing/plans" \
-H "x-api-key: $SCRAPERCOMPANY_API_KEY"Response
200 — Plans and per-endpoint credit costs.
{
"plans": [
{
"code": "free",
"name": "Free",
"monthly_credits": 1000,
"price_usd": 0,
"concurrency": 2
},
{
"code": "starter",
"name": "Starter",
"monthly_credits": 50000,
"price_usd": 49,
"concurrency": 10
}
],
"costs": [
{
"method": "POST",
"path": "/v1/calendar",
"credits": 5
},
{
"method": "POST",
"path": "/v1/ota/compare",
"credits": 20
}
],
"free": [
"GET /v1/billing",
"GET /v1/usage"
],
"notes": [
"Failed, blocked and empty results are not charged."
],
"mode": "shadow"
}Response fields
Fields marked required are always present; others appear when they apply.
- plansarray of objectrequired
Show 5 child fieldsHide child fields
- plans[].codestringrequired
Plan code.
One of
freestartergrowthscaleenterprise - plans[].namestringrequired
- plans[].monthly_creditsintegerrequired
Credits granted at the start of each period.
- plans[].price_usdintegerrequired
Monthly price in USD; 0 = free, -1 = custom (sales).
- plans[].concurrencyintegerrequired
Concurrent metered requests allowed; applied in
enforcemode.
- costsarray of objectrequired
Base credit cost of every metered operation.
Show 3 child fieldsHide child fields
- costs[].methodstringrequired
- costs[].pathstringrequired
- costs[].creditsintegerrequired
- freearray of stringrequired
Operations that never cost credits.
- notesarray of stringrequired
- modestringrequired
One of
offshadowenforce
Errors
Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.
| Status | Meaning | Retry? |
|---|---|---|
401Unauthorized | Missing or invalid API key. {"detail":"missing or invalid API key"} | No, fix the request |
429Too Many Requests | Too many requests: the key's requests-per-minute limit was exceeded, or (in {"detail":"rate limit 60/min exceeded"} | Yes, with backoff |
Try it
Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.
- Export your key:
export SCRAPERCOMPANY_API_KEY=sk_...(no key yet? start a free trial). - Copy the cURL example above and run it in a terminal.
Questions about this page?
Send the page link and your question, and the team will answer.