Rate Limits & Credits

Credit system

Every API call consumes credits. Credits are deducted when a request completes successfully. Failed requests (4xx errors caused by bad input) are not charged. Your balance resets monthly, at the start of your billing cycle. Credits do not roll over — unused credits expire at the end of the cycle, on every plan including paid ones.

Per-surface credit costs

Surface	Credits per call	Notes
Fetch (no JS)	1	Static HTML fetch, direct/stealth access tier
Fetch (JS rendering)	5	`render_js: true`, direct/stealth access tier
Fetch + extract	2 or 5	Flat 5 if extraction runs through the LLM, flat 2 otherwise — independent of `render_js`
Fetch — residential proxy surcharge	+65	Added on top of the base Fetch price only when your request needs a residential proxy — typically hardened, anti-bot-defended targets. Paid plans only.
Crawl	2 per page crawled	Charged per page, not per job. Subject to the same proxy-tier surcharge as Fetch below
Map	2 per URL mapped	Same base price and surcharge behavior as Crawl (billed under the `crawl` surface)
Interact	3	Per interaction session. Not subject to the proxy-tier surcharge below
Interact — prompt mode	25	Per session, using `prompt` instead of `actions` (see Interact). Flat regardless of how many steps the task takes
Search (no fetch)	15	Google SERP only
Search + fetch results	15 + normal Fetch cost (1 or 5) per fetched result	Each result is fetched via the standard Fetch surface, not a flat +1
Fast Search	15	Organic results only, no HTML capture. Requires a Starter plan or higher
YouTube search	10	Requires a Starter plan or higher
YouTube video details	10	Requires a Starter plan or higher
YouTube subtitles	10	Requires a Starter plan or higher
YouTube search crawl (async)	10 per page crawled	Requires a Starter plan or higher. Capped at 700 total results (`end_page * limit` must not exceed 700)
Google SERP search	15	Requires a Pro plan or higher
Amazon product / search	10	Requires a Starter plan or higher
Walmart search	10	Requires a Starter plan or higher
Booking.com search, property, reviews	15	Requires a Starter plan or higher
Agoda search, property, reviews	15	Requires a Starter plan or higher
Agoda search page 2+, reviews page 2+	25	Requires a Starter plan or higher
Airbnb search / listing	15	Requires a Starter plan or higher
Target product / search	15	Requires a Starter plan or higher
Reddit post / subreddit / user	15	Requires a Starter plan or higher
TikTok post	15	Requires a Starter plan or higher
Apple App Store app	15	Requires a Starter plan or higher
Bing search	15	Requires a Starter plan or higher
ChatGPT prompt	15	Requires a Starter plan or higher
Perplexity prompt	15	Requires a Starter plan or higher
Gemini prompt	15	Requires a Starter plan or higher

GET /v1/walmart/product was re-enabled on 2026-08-03, now backed primarily by our dedicated walmart_product target (with the generic browser-render path retained as a fallback) — this replaced the generic-only path that had been hitting frequent PerimeterX-related blocks on individual product pages.

Proxy-tier surcharge on Fetch, Crawl, and Map

Fetch, Crawl, and Map all escalate through an access-tier ladder automatically — direct HTTP, stealth browser, then a residential proxy if needed — to get past anti-bot defenses. Each surface’s base credit price only covers the direct/stealth tiers. If a specific request (or, for Crawl/Map, a specific page/URL) needs the residential proxy to succeed, a surcharge is added on top, billed off whichever tier actually served that request, not a flat rate applied to every call:

+65 credits if the request needed the residential proxy (typically hardened, anti-bot-defended targets like sites behind PerimeterX-class defenses).

Most requests never touch the proxy tier and are billed at the base price only. For Crawl/Map, the surcharge applies per page/URL — a 10-page crawl where 2 pages needed the residential proxy bills 8 × 2 + 2 × (2 + 65) = 150 credits, not a flat 10 × 2 = 20. Interact is billed at its flat per-session price regardless of access tier and is not affected by this surcharge.

`use_proxy`: skip straight to the strongest tier

Fetch, Crawl, Map, and Interact all accept an optional use_proxy: true field. By default these surfaces escalate through the access-tier ladder automatically, cheapest tier first, only advancing when a cheaper tier gets blocked. If you already know a target needs the strongest tier — e.g. you’re hitting a hardened site and expect to be blocked on anything cheaper — setting use_proxy: true skips the wasted cheap-tier attempts and goes straight there, which also reduces the chance of hitting timeout_ms mid-escalation on a tight budget. use_proxy requires a paid plan (Starter or higher) and returns 402 plan_upgrade_required immediately if set on the Free plan, since Free never reaches that tier regardless. Billing is unaffected by the flag itself — you’re still billed by whichever tier the request actually lands on (see the surcharge table above), not a separate rate for using use_proxy.

Crawl and Map auto-promote to an async job on large requests

Crawl and Map normally run synchronously, fetching every page within the same HTTP request/response. If your request is large enough that it would plausibly exceed the tenant’s inline execution budget — max_pages/max_urls above the surface’s own default (25 for Crawl, 100 for Map), or an explicit timeout_ms above your plan’s inline timeout — the API automatically queues it as an async job instead of holding the connection open, and responds the same way POST /v1/jobs does:

{ "request_id": "...", "mode": "async", "status": "queued", "job_id": "...", "reason": "..." }

Poll GET /v1/jobs/{job_id} for the result, same as any other async job. Small/default requests are unaffected and stay synchronous — you can also opt into async explicitly at any size via POST /v1/jobs with { "kind": "crawl" | "map", "input": {...} }. If a request times out before the ladder would have reached its strongest tier, the 504 timeout error includes a hint suggesting use_proxy or a higher timeout_ms, unless the request already had use_proxy set or is on the Free plan (where the hint wouldn’t apply).

Plan limits

Plan	Monthly credits	Notes
Free	1,000	Resets monthly. No proxy access — see below.
Starter	25,000	Unlocks dedicated APIs (Amazon, Walmart, Booking.com, Agoda, YouTube, Airbnb, Target, Reddit, TikTok, Apple App Store, Bing, ChatGPT, Perplexity, Gemini) and Fast Search.
Pro	100,000	Everything in Starter, plus Google SERP search.
Scale	500,000	Everything in Pro, plus custom rate limits.
Enterprise	Custom	SLA + dedicated capacity

Credits do not roll over on any plan — unused credits expire at the end of the billing cycle.

Free plan does not include proxy access

The Free plan never routes requests through a datacenter or residential proxy — only direct HTTP and stealth-browser access. Most targets work fine without either, but sites with stronger anti-bot defenses may block Free-plan requests that would succeed on a paid plan. When this happens, the API returns free_plan_proxy_required (see Error Reference) instead of a generic block, so you know upgrading is the fix rather than retrying.

Dedicated APIs and Fast Search require a paid plan

Amazon, Walmart, Booking.com, Agoda, YouTube (search, video, subtitles, and search crawl), Airbnb, Target, Reddit, TikTok, Apple App Store, Bing, ChatGPT, Perplexity, Gemini, and Fast Search all require a Starter plan or higher. Google SERP search requires a Pro plan or higher. Requesting any of these on an ineligible plan returns 402 plan_upgrade_required.

Quota errors

When your credit balance runs out, the API returns:

{
  "request_id": "...",
  "error": {
    "code": "credits_exhausted",
    "message": "Your plan's credit allowance has been exhausted. Buy a top-up or upgrade to continue."
  }
}

Code	Status	When
`credits_exhausted`	402	Balance is zero

Credits are a hard cap, not billed overage — requests are blocked once your plan’s included credits run out. Buy a top-up or upgrade to a higher plan to keep going.

Checking your usage

Use the usage field in every successful inline response to see how many credits that call consumed:

{
  "usage": { "credits": 5 }
}

Aggregate usage dashboards are available at scrapio.dev.

Getting Started

Guides

API Reference

Rate Limits & Credits

Credit system

Per-surface credit costs

Proxy-tier surcharge on Fetch, Crawl, and Map

`use_proxy`: skip straight to the strongest tier

Crawl and Map auto-promote to an async job on large requests

Plan limits

Free plan does not include proxy access

Dedicated APIs and Fast Search require a paid plan

Quota errors

Checking your usage

​Credit system

​Per-surface credit costs

​Proxy-tier surcharge on Fetch, Crawl, and Map

​use_proxy: skip straight to the strongest tier

​Crawl and Map auto-promote to an async job on large requests

​Plan limits

​Free plan does not include proxy access

​Dedicated APIs and Fast Search require a paid plan

​Quota errors

​Checking your usage

Credit system

Per-surface credit costs

Proxy-tier surcharge on Fetch, Crawl, and Map

`use_proxy`: skip straight to the strongest tier

Crawl and Map auto-promote to an async job on large requests

Plan limits

Free plan does not include proxy access

Dedicated APIs and Fast Search require a paid plan

Quota errors

Checking your usage