Batches

Batch Screenshots

Submit hundreds of URLs in a single request and retrieve all screenshots asynchronously.

What is a batch?

A batch lets you submit multiple URLs in a single API call. Each URL is processed asynchronously by the distributed browser network and the results are stored for retrieval.

Creating a batch

POST /api/v1/batch/create
{
  "urls": [
    "https://example.com",
    "https://example.com/about",
    "https://example.com/pricing"
  ],
  "country": "us"
}

The response includes a batch_id.

Polling for completion

Use GET /api/v1/batch/info?id={batch_id} to check progress. The response includes a status field (pending, processing, finished, failed) and a list of individual screenshot statuses.

Retrieving results

Once the batch is finished, retrieve individual screenshots using the standard GET /api/v1/screenshot/thumbnail endpoint with each screenshot_id from the batch results.

Rate limits

Batch sizes depend on your subscription plan. Check the Pricing page for limits per plan.