Credits
How much you may spend before your cycle renews or you top up. Set by your plan.
Rate limit
How fast you may spend it, in requests per minute. Also set by your plan.
Credit cost per endpoint
Endpoints come in two tiers. Light endpoints fetch and parse — no browser involved. Render endpoints boot headless Chromium, or crawl more than one page.
Starting a crawl costs credits once, when you start it; polling its status and downloading the resulting file are always free and don’t count toward your rate limit either. See Async Jobs & Polling.
Failed requests are never billed
Credits are reserved before your request runs and confirmed only after it finishes — so a burst of concurrent requests can never collectively overdraw a balance that each one individually saw as sufficient. If the request then fails (any non-2xx response, or the connection drops mid-render), the reservation is automatically refunded. You are only ever charged for a response that actually succeeds.Plans
The Free plan’s 100 credits/month is the allowance for a signed-in visitor using the website’s tool pages — it does not include API key access. Programmatic access starts on Starter.
Anonymous (signed-out) allowance
No account at all still gets a small, deliberately limited allowance, tracked per IP:- 10 credits per day
- 10 requests per minute
Top-up packs
On any paid plan, buy additional credits that don’t expire with the billing cycle:
Cycle credits are spent before top-up credits.
Response headers
Every/v1 response carries these headers, whether it succeeds or fails:
Unique ID for this request. Include it when contacting support about a specific call.
Credits this request cost (0 for free endpoints).
Your balance immediately after this request was reserved.
Your plan’s requests-per-minute ceiling.
Requests left in the current one-minute window.
Seconds until the window resets.
Light
GET endpoints also send Cache-Control: no-store. Without it, a browser or intermediary could serve a stale scan from cache, or silently revalidate and re-run the whole thing for a 304 — neither is what re-running a scan should do.429 vs. 402: which limit did you hit
402 responses include a creditsRequired field so you know exactly how far short you were:
Authentication
How each caller type is identified and billed.
Errors
The full error code reference.