Batch

Process thousands of URLs reliably, in one job, and check the cost before you spend a single credit.

zenrows batch runs the same fetch or extract job across a list of URLs as a single, trackable job: submit once, then check status or collect results whenever you want.

zenrows batch <estimate|create|status|results|cancel|wait|retry-failed> [flags]

jobs.jsonl is one JSON object per line, each with a url and optional per-line overrides (js_render, premium_proxy, proxy_country).

Local, no key needed

zenrows batch estimate jobs.jsonl

Validates the spec and estimates credit cost with no cloud call. Run this before submitting a real job.

Cloud

# Submit a job and wait for it to finish
zenrows batch create jobs.jsonl --wait

# Check status
zenrows batch status <job-id>

# Collect results (paginated)
zenrows batch results <job-id> --out results.jsonl

# Rerun only the failed tasks
zenrows batch retry-failed <job-id>

# Stop an in-flight run
zenrows batch cancel <job-id>

Flags

--json (print structured output) works on every subcommand. The rest are subcommand-specific:

Subcommand	Flags
create <file.jsonl>	--js-render, --premium-proxy, --proxy-country <cc> (needs --premium-proxy), --output <fmt> (markdown|plaintext|pdf), --wait
results <id>	--status <successful|failed|all>, --out <file>, --download <dir> (fetches each result body, plus a _manifest.jsonl)
wait <id>	--timeout <ms>