Skip to main content

Use Tovuk scraper APIs from a native CLI.

Project description

tovuk

Python package for launching the native Tovuk Rust CLI. It installs or downloads the same binary used by npm, Homebrew, and Cargo.

pipx install tovuk
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 scraper list --json
tovuk scraper health --json
tovuk scraper show tiktok --json
tovuk request list --limit 20 --json
tovuk request list --limit 20 --cursor <nextCursor> --json
tovuk request create reddit '{"subreddit":"rust","sort":"new","limit":100}' --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 usage --json
tovuk billing checkout plus --json
tovuk billing portal --json
tovuk support create "Request failed" "Request failed after retry." --request-id request_123 --scraper-id tiktok --failing-command "tovuk request show request_123 --json" --first-log-line "upstream timeout" --json

Use tovuk request list --limit <n> --cursor <nextCursor> --json and tovuk request results <request_id> --limit <n> --cursor <nextCursor> --json to continue request and stored-result pagination.

Set TOVUK_OUTPUT=json for agent sessions. Set TOVUK_NATIVE_BINARY=/path/to/tovuk to test a local binary.

The CLI does not deploy websites, backends, databases, workers, storage buckets, queues, cron jobs, custom domains, secrets, or other customer infrastructure.

AI/API agents may also open account-scoped service tickets between your account and Tovuk through POST /v1/support/tickets with an account API key or session bearer token. Ticket responses include created_by for account-session versus account-API-key attribution.

Scraper requests are public data only. Do not send cookies, passwords, account tokens, private session data, private account content, private repository credentials, or proxy URLs.

Homebrew uses the main public repository tap:

brew tap tovuk/tovuk https://github.com/tovuk/tovuk
brew install tovuk

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tovuk-0.1.113.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tovuk-0.1.113-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file tovuk-0.1.113.tar.gz.

File metadata

  • Download URL: tovuk-0.1.113.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for tovuk-0.1.113.tar.gz
Algorithm Hash digest
SHA256 d6d10d9b1b8e68a301d4f2ea2af2cde0fd55314fa26df05a71db4640a9e2e2f3
MD5 57ce0498e5b14e6d3dc4e7fb57114cec
BLAKE2b-256 decd2fe1b12f6e6aae6e856ca1d1e9d103b6155abf9c1f096d9dd99e68f9e664

See more details on using hashes here.

Provenance

The following attestation bundles were made for tovuk-0.1.113.tar.gz:

Publisher: publish-pypi.yml on tovuk/tovuk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tovuk-0.1.113-py3-none-any.whl.

File metadata

  • Download URL: tovuk-0.1.113-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for tovuk-0.1.113-py3-none-any.whl
Algorithm Hash digest
SHA256 9ab44d14dc0dd710b2f9d5edfafe47af87f3879a172faac19c7c570b43ab6d7d
MD5 7b6336113d2669535e349a582a46360c
BLAKE2b-256 bf36d68328bb94527f1fb12e93b8f4bd5d1668e1d7abfbe47fb381e6f5a35b1d

See more details on using hashes here.

Provenance

The following attestation bundles were made for tovuk-0.1.113-py3-none-any.whl:

Publisher: publish-pypi.yml on tovuk/tovuk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page