> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> You pay for Stophy in prepaid dollars. A scrape costs $1 per 1,000 pages and a search $1 per 1,000. New accounts get $2, and a failed call is free.

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](https://docs.stophy.dev/production/rate-limits.md).

### Auto top-up

After a top-up you can turn on auto top-up at [stophy.dev/billing](https://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.

| Endpoint | Price |
| - | - |
| [Scrape](https://docs.stophy.dev/scrape/overview) | \$1 per 1,000 pages. Some options add to it. See [Scrape options](#scrape-options). |
| [Map](https://docs.stophy.dev/map/overview) | \$0.50 per 1,000 calls |
| [Crawl](https://docs.stophy.dev/crawl/overview) | \$1 per 1,000 pages, charged as each page finishes. Starting the crawl is free. |
| [Batches](https://docs.stophy.dev/batches/overview) | Each page costs what a scrape costs. Starting the batch is free. |
| [Search](https://docs.stophy.dev/search/overview) | $0.001 for each 10 results from each source and each research or videos list, which is $1 per 1,000 searches of up to 10 results. Web or news results that come back with their page text add $1 per 1,000 results. A summary or `json` result adds $3 per 1,000 more. |
| [Extract](https://docs.stophy.dev/extract/overview) | $5 per 1,000 pages for most pages: the page's own price plus $4 per 1,000. Each page after the first costs $1 per 1,000 more. A long answer costs $1 per 1,000 more for every 64 values after the first 64, for each 40,000 characters of page text read. A call that finds none of the fields is free. |
| [Agent](https://docs.stophy.dev/agent/overview) | Each search and page at its normal price, plus \$3 per 1,000 for each planning or answering step that returns something. It never costs more than the cap you send. Starting the run is free. |
| [Parse](https://docs.stophy.dev/parse/overview) | $0.50 per 1,000 pages or files whose text comes from a text layer, and $2.50 per 1,000 pages read from their picture, up to `maxPages`. `summary` and `json` with a schema or a prompt add \$3 per 1,000 each. |
| [Crawl preview](https://docs.stophy.dev/crawl/describe.md) | \$0.003 per call |
| [Browser sessions](https://docs.stophy.dev/browser/overview) | $0.06 per hour open, or $0.84 per hour once a prompt has run, billed when the session closes, one minute at least. Network traffic adds $5 per GB through the default network and $0.20 per GB direct or through your own proxy. |
| [Interact on a scrape](https://docs.stophy.dev/scrape/interact.md) | Billed like a browser session |
| [Browser tasks](https://docs.stophy.dev/browser/tasks.md) | \$0.84 per hour of browser time the task runs, billed by the minute, one minute at least, up to `maxCost`. A task that ends before its first step costs nothing. |
| [Monitors](https://docs.stophy.dev/monitors/overview) | What a scrape costs for each page, on every check |

### Scrape options

These add to the \$1 per 1,000 pages when they return something.

| Option | Adds |
| - | - |
| `json` with a schema or a prompt, `summary`, `highlights`, `question`, `product`, `menu`, `changeTracking` in `json` mode | \$3 per 1,000 pages each |
| `checkPromptInjection` | \$2.50 per 1,000 pages when the scan runs |
| A PDF | $0.50 per 1,000 pages of text from its text layer and $2.50 per 1,000 pages of text read from its picture, that come back. A PDF read with `maxChars`, `offset` or `query` is charged for the share of its pages that it returns, at least one page. |
| `zeroDataRetention` | \$2 per 1,000 pages. See [Zero data retention](https://docs.stophy.dev/production/zero-data-retention.md). |

[Browser actions](https://docs.stophy.dev/scrape/browser-actions.md) 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](https://docs.stophy.dev/scrape/prebuilt-parsers) costs the parser's price, and most parsers cost \$1 per 1,000 calls. These parsers cost more, or charge for what comes back.

| Parser | Price |
| - | - |
| `zillow-search` | \$4 per 1,000 calls |
| `google-maps-reviews` | \$0.001 for each 10 reviews |
| `appstore-search`, `appstore-top`, `google-play-search` | \$0.001 for each 10 apps |
| `craigslist-search` | \$0.001 for each 10 listings |
| `reddit-post` | \$0.001 for each 200 comments |
| `tiktok-trending` | \$0.001 for each 10 videos |
| `instagram-transcript` | $0.002 per video plus $0.24 per hour of audio, up to 5 minutes |
| `tiktok-transcript` | $0.001 per video that has captions. Otherwise $0.004 per video plus \$0.72 per hour of audio, up to 3 minutes. |

The [parser list](https://api.stophy.dev/v1/parsers) 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](https://docs.stophy.dev/account/usage.md), [`GET /v1/endpoints`](https://api.stophy.dev/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](https://docs.stophy.dev/production/agent-feedback.md) 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.

```json theme={null}
{
  "success": true,
  "data": { "metadata": { "statusCode": 200, "costUsd": 0.001 } },
  "costUsd": 0.001
}
```

`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](https://docs.stophy.dev/production/usage-and-logs.md).

## 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.

```json theme={null}
{
  "success": false,
  "error": "Your balance is $0.001 and this call can cost up to $0.002. Add funds at https://stophy.dev/billing.",
  "code": "insufficientCredits",
  "requiredUsd": 0.002,
  "availableUsd": 0.001,
  "billingUrl": "https://stophy.dev/billing"
}
```

This is the shape from the [API reference](https://docs.stophy.dev/api-reference/errors.md). 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](https://docs.stophy.dev/production/agent-feedback.md).

## Related

* [API keys](https://docs.stophy.dev/account/api-keys.md)
* [Usage](https://docs.stophy.dev/account/usage.md)
* [Rate limits](https://docs.stophy.dev/production/rate-limits.md)
* [Troubleshooting](https://docs.stophy.dev/production/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.