Docs/Docs / Billing

Credit Costs

How credits are consumed across scrape, map, and crawl flows in the managed cloud.

Published
March 11, 2026
Updated
March 11, 2026
Category
docs
Per-endpoint billing truthCrawl polling explainedBalance endpoint included

Current billing rules

OperationCredit cost
scrape1 credit
map1 credit
crawl start1 credit
crawl pollingNew pages discovered since the previous poll

Why crawl billing looks different

The crawl start reserves the job. Subsequent polls charge only for newly materialized pages, not for the total accumulated page count each time.

That prevents the same already-seen pages from being charged again and again just because you are checking progress.

Simple Examples

ScenarioCredit effect
One scrape request1 credit
One map request1 credit
Start one crawl job1 credit
Poll a crawl and receive 7 new pages7 additional credits
Poll again with no new pagesNo new page credits

What Usually Does Not Consume Permanent Credits

The billing logic is designed to avoid charging you for requests that never become real usable work. Validation failures and certain upstream failures are refunded rather than treated like successful paid execution.

The safest way to confirm actual consumption is still the balance endpoint before and after a test.

Balance check

Use GET /api/v1/account/balance with your API key to inspect included credits, purchased balance, and total available credits.

Operational Advice

  • Use small test batches before large crawls.
  • Check balance before and after integration changes.
  • Separate "request volume" monitoring from "credit consumption" monitoring; they are related but not identical.