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

# Credits & pricing

> Per-endpoint costs, stealth surcharges, and how billing works.

Billing is **credit-based**. Each endpoint has a fixed cost, and new accounts start with **500 credits** to play with.

<CardGroup cols={2}>
  <Card title="Per call" icon="bolt">
    Scrape, SmartScraper. Billed once per successful request.
  </Card>

  <Card title="Per page" icon="file-lines">
    SmartBrowse. Billed per page successfully extracted (initial load + each pagination hop).
  </Card>
</CardGroup>

<Note>
  **Failed requests cost 0 credits.** You only pay on success. Internal retries on our end aren't your problem.
</Note>

## Per-endpoint costs

<Snippet file="credits-table.mdx" />

## Stealth mode

Stealth mode swaps the default fetcher for a real Chrome session. Set `stealth: true` in the request body to enable it. The surcharge is added on top of the base cost — see the table above, or [Stealth mode](/docs/concepts/stealth-mode) for when to use it.

## SmartBrowse pricing detail

`POST /v1/smartbrowse/recipes/:id/run` charges 2 credits per page extracted — the initial load, plus each pagination hop. We bill on completion only. Cancelled, failed, or timed-out runs cost 0.

## Checking your balance

Every successful response includes `credits_used` and `credits_remaining`. Most production code only reads those two fields:

```json theme={null}
{
  "status": "completed",
  "data": { "...": "..." },
  "credits_used": 5,
  "credits_remaining": 495,
  "request_id": "req_aB3xY9Kp"
}
```

`credits_remaining` is your balance after this call has been deducted.

The async-dispatch endpoint (`POST /v1/smartbrowse/recipes/:id/run`) returns a `queued` envelope without the credit fields, because the work hasn't run yet:

```json theme={null}
{
  "status": "queued",
  "data": {
    "run_id": "k7Xb9dRmQ2p",
    "recipe_id": "m3Yc2tFvN8q",
    "run_status": "running",
    "poll_url": "/v1/smartbrowse/runs/k7Xb9dRmQ2p",
    "created_at": "2026-05-21T17:42:01Z"
  },
  "request_id": "req_aB3xY9Kp"
}
```

Credits add up page by page as the run goes; poll the `poll_url` to watch it happen. Hit zero and the next call returns `402 Payment Required`. Top up from the [Billing](https://webscrape.ai/app/billing) page.

## Free credits

* **Signup:** 500 credits.
* **Onboarding bonuses:** verify your email or finish the tasks in the [onboarding wizard](https://webscrape.ai/app/onboarding).
