Use status endpoints to distinguish Tovuk API availability from a scraper
request failure.
curl https://api.tovuk.com/health
curl https://api.tovuk.com/healthz
curl https://api.tovuk.com/v1/status
tovuk scraper health --json
/health is the simple public health alias. /healthz is the readiness probe.
/v1/status returns structured availability state, stable public identifiers,
per-check latency_ms and latency_us, optional non-secret diagnostic
metadata, agent_instruction, and docs links. Use latency_us for fast probes
that round down to latency_ms: 0. A check message is reachable,
unavailable, or timed_out. tovuk scraper health --json returns
data-source readiness for high-count public-data work without exposing service
topology or provider configuration.
When the CLI cannot reach the API, it returns api_unreachable with a status
docs URL. Retry once, then check /v1/status before changing scraper inputs. Last modified on July 11, 2026
