Skip to content
Help Center Batches Batch File Format (CSV / TSV)

Batches

Batch File Format (CSV / TSV)

Upload a CSV or TSV file to submit multiple URLs in a single batch request.

File format

Each line in the file represents one URL to capture. You can use either comma-separated values (CSV) or tab-separated values (TSV).

Minimal format — one URL per line

https://example.com
https://example.com/about
https://example.com/pricing

Extended format — URL plus per-row overrides

Add additional columns to override specific parameters per URL. Supported column headers match the API parameter names:

url,country,browser,delay
https://example.com,us,chrome,2
https://example.de,de,firefox,0
https://example.fr,fr,chrome,1

TSV example

url	country	delay
https://example.com	us	2
https://example.co.uk	gb	0

Rules

  • The first row may be a header row (column names) or a data row — both are accepted.
  • UTF-8 encoding is required.
  • Maximum file size and URL count depend on your subscription plan.
  • Lines starting with # are treated as comments and ignored.

Last updated March 27, 2026