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

# Pricing

> Paid scraper plans, included balance, per-result prices, and usage checks.

Tovuk uses balance-based scraper pricing. Pick a monthly plan, receive the
included balance, and Tovuk deducts from that balance for each successful stored
result record.

There is no free scraper tier. Catalog reads are public, but creating a scraper
request requires paid billing.

## Plans

| Plan | Monthly price | Included balance | Best for                         |
| ---- | ------------: | ---------------: | -------------------------------- |
| Plus |   `$20/month` |            `$20` | Small, steady API usage          |
| Pro  |  `$100/month` |           `$120` | Regular research and enrichment  |
| Max  |  `$200/month` |           `$300` | Daily scraping and higher volume |

Manual top-ups and auto top-ups start at a `$20` minimum. Use Stripe-hosted
checkout and portal flows:

```sh theme={"dark"}
tovuk billing checkout plus --json
tovuk billing checkout --top-up-usd-cents 2000 --json
tovuk billing portal --json
```

## Per-Result Prices

Prices are charged only for successful stored records. API responses expose exact
prices as USD micro-units in `priceEvents[].usdMicros`; `1,000,000` means
`$1.00`.

| Scraper                   | Unit   | Price per 1,000 results |
| ------------------------- | ------ | ----------------------: |
| Reddit Scraper            | record |                 `$0.70` |
| GitHub Scraper            | record |                 `$0.60` |
| Google Maps Scraper       | place  |                 `$1.20` |
| Amazon Scraper            | record |                 `$1.40` |
| Alibaba Scraper           | record |                 `$1.50` |
| Temu Scraper              | record |                 `$1.60` |
| Etsy Scraper              | record |                 `$1.20` |
| Apple App Store Scraper   | record |                 `$1.40` |
| Google Play Store Scraper | record |                 `$1.40` |
| Trendyol Scraper          | record |                 `$1.40` |
| Hepsiburada Scraper       | record |                 `$1.40` |
| YouTube Scraper           | record |                 `$1.40` |
| Zillow Scraper            | record |                 `$1.50` |
| Indeed Scraper            | record |                 `$1.20` |
| Trustpilot Scraper        | record |                    `$1` |
| LinkedIn Scraper          | record |                 `$0.90` |
| TikTok Scraper            | record |                 `$1.70` |
| Instagram Scraper         | record |                 `$0.80` |
| X Scraper                 | post   |                 `$0.30` |

Read the live catalog before estimating work:

```sh theme={"dark"}
tovuk scraper list --json
tovuk scraper show tiktok --json
```

## How Billing Works

When `limit` is known, request creation returns an estimated maximum cost. The
final charge is based on the number of successful records saved:

```txt theme={"dark"}
final charge = stored result count * scraper result price
```

Failed requests and empty results do not create per-result charges. The result
records remain available through the results API so agents and scripts do not
need to build a separate storage layer.

Check balance, usage, invoices, and current-month estimates:

```sh theme={"dark"}
tovuk usage --json
tovuk account show --json
```

`usage.billingEstimate.lineItems` shows the current-month scraper result meters,
used result counts, unit prices, and estimated spend.

## API Paths

```http theme={"dark"}
GET /v1/data-sources
GET /v1/data-sources/{data_source}
POST /v1/requests
GET /v1/requests/{request_id}
GET /v1/requests/{request_id}/results
```

Use public URLs, public handles, public search terms, or public identifiers only.
Do not send cookies, passwords, account tokens, private session data, or proxy
URLs through the public API or CLI.