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

> Every price, what is free, how your prepaid balance and auto top-up work, and where to read what a call cost. A failed call costs nothing.

You prepay a dollar balance. Each call takes its price out when it finishes. `GET /v1/endpoints` lists the same prices: `costUsd` is the least a call can cost and `maxCostUsd` the most.

## Prices

Most used first.

| Endpoint | Price |
| - | - |
| [Scrape](https://docs.stophy.dev/scrape/overview) | $1 per 1,000 pages. Options add to it, see [Scrape add-ons](#scrape-add-ons). At most $0.1165 a page. |
| [Search](https://docs.stophy.dev/search/overview) | \$0.001 per block of up to 10 results, counted for each source and each research or videos list. Page reads with `scrapeOptions.formats` use scrape prices. |
| [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 is free. |
| [Batches](https://docs.stophy.dev/batches/overview) | Scrape price for each page. Starting is free. |
| [Extract](https://docs.stophy.dev/extract/overview) | $5 per 1,000 pages: the page price plus $4 per 1,000. Each page after the first adds $1 per 1,000. A long answer adds $1 per 1,000 for every 64 values after the first 64, for each 40,000 characters read. No field found is free. |
| [Parse](https://docs.stophy.dev/parse/overview) | $0.50 per 1,000 pages or files read from a text layer, $2.50 per 1,000 read from a picture, up to `maxPages`. `summary` and `json` with a schema or a prompt add \$3 per 1,000 each. |
| [Agent](https://docs.stophy.dev/agent/overview) | Each search and page at its own price, plus \$3 per 1,000 for each planning or answering step that returns something. Never more than `maxCredits`. Starting is free. |
| [Browser sessions](https://docs.stophy.dev/browser/overview) | $0.06 an hour open, or $0.84 an hour for the whole session once a prompt has run. Billed when the session closes. Code-only time rounds up to 2 minutes. Prompted time has a one-minute minimum and rounds up in $0.002 steps. Traffic adds $5 per GB on the default network (400 kB blocks) or \$0.20 per GB direct or on your own proxy (10 MB blocks). |
| [Interact on a scrape](https://docs.stophy.dev/scrape/interact.md) | Browser session prices |
| [Browser tasks](https://docs.stophy.dev/browser/tasks.md) | \$0.84 an hour of task time, billed by the minute, one minute at least, up to `maxCost`. A task that ends before its first step is free. |
| [Monitors](https://docs.stophy.dev/monitors/overview) | Scrape price for each page on each check. A search target costs the search price. Watched `json` adds $3 per 1,000 when it comes back. A judgement adds $0.001. |
| [Developer search](https://docs.stophy.dev/search/developer.md) | \$0.001 per block of up to 10 results |
| [Research papers](https://docs.stophy.dev/search/papers.md) | $0.001 per block of up to 10 results, and $0.001 to read one paper |
| [Crawl preview](https://docs.stophy.dev/crawl/describe.md) | \$0.003 per call |

### Scrape add-ons

They add to the \$1 per 1,000 pages when they return something. [Browser actions](https://docs.stophy.dev/scrape/browser-actions.md) and CSS rules add nothing.

| Option | Adds per 1,000 pages |
| - | - |
| `json` with a schema or a prompt, `summary`, `highlights`, `question`, `product`, `menu`, `changeTracking` | \$3 each |
| `checkPromptInjection` | \$2.50 when the scan runs |
| PDF | $0.50 of text from its text layer, $2.50 of text read from its picture. With `maxChars`, `offset` or `query` you pay for the share of pages returned, one page at least. |
| `zeroDataRetention` | \$2 per 1,000 scraped URLs, not per PDF page. Not charged on an error status. See [Zero data retention](https://docs.stophy.dev/production/zero-data-retention.md). |

An answer from a stored copy within `maxAge` costs a full read. A page you cannot read costs nothing. The page price is waived for a readable 404 or 410.

### Parsers

A [parser](https://docs.stophy.dev/scrape/prebuilt-parsers) costs \$1 per 1,000 calls unless listed. `GET /v1/parsers` returns each `price`.

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

## Balance

A new account gets $2 once, with no card. Top up at [stophy.dev/billing](https://stophy.dev/billing) from $10 to \$10,000. The balance does not expire. All purchases are final.

The first top-up saves your card and moves the account from `free` to `paid`. [Rate limits](https://docs.stophy.dev/production/rate-limits.md) step up at $10, $100 and \$500 topped up in all.

After a top-up you can turn on auto top-up at the same page. Pick an amount from $10 to $10,000 and a monthly limit of at least that amount. When a call needs more than your balance, Stophy charges the card and runs the call. At the monthly limit, or if the card declines, the call fails with `insufficientCredits` and the message says which.

A call your balance cannot cover returns `402` with `insufficientCredits` and charges nothing. Stophy checks the balance against the most the call can cost, so a call can fail while the balance covers the usual price. `availableUsd` is your balance, `requiredUsd` the most the call can cost, `billingUrl` where to top up. A browser task you cannot cover tells you to add funds or lower `maxCost`.

## Free

* A call that fails, a page that returns 404 or 410, a page you cannot read, and an extract that finds no field.
* Status, results, cancel and list calls for jobs and monitors, and webhook delivery reads.
* Account calls: [limits, usage, history and logs](https://docs.stophy.dev/account/usage.md), `GET /v1/endpoints`, `GET /v1/parsers`, `GET /v1/status`, sign-up and sign-in.
* Creating, listing and reading browser profiles, extensions, network policies, recordings and replays. Only session time and traffic cost.
* [Feedback](https://docs.stophy.dev/production/agent-feedback.md). A bad rating refunds that call, up to \$0.10 a day.

## Read what a call cost

* `x-cost-usd` header on every response.
* `data.metadata.costUsd` on scrape and parse. Job status, account, browser and monitor calls put `costUsd` at the top level of the body.
* `creditsUsed` and `x-credits-used` are older fields for the same cost in steps of \$0.002. Use `costUsd`.
* `GET /v1/limits` shows your balance. `GET /v1/logs` shows what each recent call cost. See [Usage and logs](https://docs.stophy.dev/account/usage.md).


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