Skip to main content

​
Reading usage from responses

Every successful inline response includes a usage field:
Async jobs don’t currently report a usage/credits field anywhere in the job status or result response — the deduction happens server-side and isn’t surfaced back to the caller today.

​
Estimating costs

Use the credit table in Rate Limits & Credits to estimate costs before running large jobs. A quick formula for crawls:
Crawl bills a flat 2 credits per page regardless of extraction — render_js isn’t a Crawl parameter, and adding extract doesn’t change the per-page cost. For a plain Fetch call, credits are 1 for a static request or 5 with render_js: true — but once extract is set (any mode), the cost becomes a flat 5 credits if extraction runs through the LLM, or 2 credits otherwise, independent of render_js.

​
Balance exhaustion behaviour

Credit balance is checked once, at authentication, before a crawl starts — a 402 with credits_exhausted is returned up front if you’re already out of credits. Once a crawl is running, it isn’t re-checked mid-run and won’t stop partway through if your balance hits zero.

​
Monitoring usage

You can monitor usage through:
  1. Per-response usage field — inspect credits in every API response.
  2. Dashboard — aggregate usage at scrapio.dev.

​
Reducing credit usage

  • Use render_js: false when pages don’t need JavaScript (saves 4 credits per fetch — only applies when extract isn’t set; extraction cost is flat regardless of render_js).
  • Use mode: "selectors" or engine: "heuristic" extraction instead of the LLM where the DOM is stable (saves 3 credits per fetch: 2 instead of 5).
  • Set a tight max_pages on crawls to avoid over-crawling.
  • Use same_domain_only: true (the default) to prevent the crawler from following external links.
  • Cache results client-side when the same URL is fetched repeatedly.

​
Upgrading your plan

Visit scrapio.dev#pricing to upgrade from Free to a paid plan. Starter includes 25,000 credits/month and unlocks the dedicated APIs and Fast Search; Pro includes 100,000 credits/month and adds Google SERP search, higher timeout_ms limits, and priority execution; Scale includes 500,000 credits/month. Credits do not roll over on any plan.