CLI

Bulk

Bulk screenshot operations

Bulk screenshot operations

bulk › screenshots

Bulk screenshot sub-resources

OptionDescription
-h, --helpdisplay help for command

bulk › screenshots › list

List screenshots in a bulk job

OptionDescription
-h, --helpdisplay help for command
$ bytekit bulk screenshots list <id>

bulk › create

Create a bulk screenshots job

OptionDescription
--file <path>Path to a newline-delimited file. Each line is a plain URL, or a JSON object carrying "url" plus per-item config. A line whose only key is "url" behaves exactly as before (sent as a bare URL string); any line with additional keys switches the payload to the per-item shape.
--webhook-url <url>HTTPS webhook URL notified when the job completes
--webhook-secret <secret>HMAC secret used to sign the completion webhook (omitted → unsigned)
--defaults <json>Defaults applied to every entry, as a JSON object (omitted → none). Unknown keys are rejected by /v1/bulk (422) and ignored by scrape bulk / fetch bulk; fetch bulk additionally rejects browser-only keys (cookies, wait_until, wait_for_selector, delay_ms) with a 400.
--metadata <json>Arbitrary metadata echoed on the job envelope, as a JSON object, e.g. '{"run":"7"}' (omitted → none)
-h, --helpdisplay help for command
$ bytekit bulk create --file <path> --webhook-url <url> --webhook-secret <secret> --defaults <json> --metadata <json>

bulk › get

Get a bulk job status

OptionDescription
-h, --helpdisplay help for command
$ bytekit bulk get <id>

bulk › cancel

Cancel an in-flight bulk job

OptionDescription
-h, --helpdisplay help for command
$ bytekit bulk cancel <id>