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

# Tovuk

> Paid public-data scraper API with a native Rust CLI.

Tovuk lets agents and scripts create paid scraper Requests, poll status, and
fetch stored Records without building a separate storage layer.

<CardGroup cols={2}>
  <Card title="Start Scraping" icon="terminal" href="/quickstart">
    Install the native CLI, log in, list Scrapers, create a Request, and read
    stored Results.
  </Card>

  <Card title="Scraper API" icon="search" href="/scrapers">
    Review supported public-data Scrapers, request inputs, prices, and API
    routes.
  </Card>

  <Card title="Agent Workflow" icon="bot" href="/agents">
    Use the exact JSON-first command sequence for automated scraper runs.
  </Card>

  <Card title="Pricing" icon="credit-card" href="/pricing">
    Compare plans, included balance, and per-result prices.
  </Card>
</CardGroup>

## First Run

```sh theme={"dark"}
tovuk login --json
tovuk account show --json
tovuk api-key list --json
tovuk api-key create "Production scraper" --json
tovuk api-key revoke api_key_0123456789abcdef01234567 --json
tovuk pricing --json
tovuk usage --json
tovuk scraper list --json
tovuk scraper health --json
tovuk scraper show tiktok --json
tovuk request create tiktok '{"operation":"search","query":"rust programming","limit":100}' --json
tovuk request show request_123 --json
tovuk request results request_123 --limit 1000 --json
tovuk billing checkout plus --json
tovuk billing portal --json
```

Use `--cursor <nextCursor>` with `tovuk request list` and `tovuk request results`
to continue request and stored-result pagination.

## Product Boundary

The public CLI does not deploy websites, backends, databases, workers, storage
buckets, queues, cron jobs, custom domains, secrets, or other customer
infrastructure. It is a scraper API client.

Scraper requests are public data only. They must use public URLs, public search terms, public profile
handles, public place ids, or public identifiers only. Do not send cookies,
passwords, account tokens, private session data, private account content,
private repository credentials, or proxy URLs.

## Install

```sh theme={"dark"}
cargo install --locked tovuk
npm install -g tovuk
pipx install tovuk
brew tap tovuk/tovuk https://github.com/tovuk/tovuk
brew install tovuk
```
