Skip to main content
Your account holds a balance in dollars. Each call takes its price out of the balance when it finishes, at a list price per 1,000 calls or per hour. The price is the same whatever you spend. costUsd in each response is what the call cost.

Your balance

A new account starts with $2 to spend, with no card. Each person gets this start amount once. When you need more, top up at [stophy.dev/billing](https://stophy.dev/billing), from $10 to $10,000 at a time. Your balance does not expire and applies to every endpoint. All purchases are final. A first top-up saves your card and moves the account from the free tier to the paid tier, which has higher rate limits.

Auto top-up

After a top-up you can turn on auto top-up at stophy.dev/billing. Choose an amount from $10 to $10,000 and a monthly limit that is at least that amount. When a call needs more than your balance, Stophy charges your saved card for the amount and runs the call. When the monthly limit is used up, or the card is declined, the call fails with insufficientCredits and the message says which.

What a call costs

These are the list prices. GET /v1/endpoints also shows each endpoint’s price. Its costUsd is the lowest a call can cost, and maxCostUsd the most.

Scrape options

These add to the $1 per 1,000 pages when they return something. Browser actions and CSS rules add nothing. An answer from a stored copy within maxAge costs the same as a live read. One scrape can cost at most $0.0265.

Parsers

Scrape with a parser costs the parser’s price, and most parsers cost $1 per 1,000 calls. These parsers cost more, or charge for what comes back. The parser list has every parser’s price.

What is free

  • A call that fails costs nothing.
  • A page that comes back with a 404 or 410 status, or cannot be read, costs nothing.
  • Extract with none of the fields found costs nothing.
  • Status, results, cancel and list calls for crawls, batches, extracts, agent runs and monitors, and the calls that read webhook deliveries, cost nothing.
  • Account calls cost nothing: limits, usage, history and logs, GET /v1/endpoints, GET /v1/parsers, GET /v1/status, sign-up and sign-in.
  • Browser profiles, extensions, network policies, recordings and replays cost nothing to create, list and read. Only the session time and traffic cost.
  • Feedback costs nothing.

Read what you were charged

Every response has costUsd, and the x-cost-usd header says the same. Scrape also puts it in data.metadata.costUsd. This real scrape of example.com cost $0.001. The same scrape with `zeroDataRetention` cost $0.003.
creditsUsed and x-credits-used are older fields that count the same cost in steps of $0.002. Use costUsd. GET /v1/limits shows your balance in dollars, and GET /v1/logs lists your recent calls with what each cost. See Usage and logs.

When your balance runs out

A call your balance cannot cover fails with status 402 and code insufficientCredits, and charges nothing. The balance is checked against the most the call can cost, so a call whose price depends on what comes back can fail while the balance still covers the usual price. The error names the balance, the most the call can cost, and where to add money.
This is the shape from the API reference. The numbers are an example. requiredUsd and availableUsd are in dollars. The x-required-credits and x-available-credits headers say the same in steps of $0.002. A browser task that cannot be covered tells you to add funds or send a lower maxCost.

Refunds

A bad rating on a call refunds what that call cost, up to $0.10 a day. See Agent feedback.