Skip to main content
For a single session use Create a Session. See Browser Sessions for when to choose batch vs sync or async.
Create up to 5,000 browser sessions in a single API call for large-scale automation, web scraping, and load testing.

Quick Start

1. Create a Batch

2. Monitor Progress

3. Use Sessions

Polling Strategy

Parameters

count
number
required
Number of browser sessions to create (1-1000)
configuration
object
Session configuration that applies to all sessions in the batch
metadata
object
Optional key-value pairs for batch identification

Status States

Batch States: pendingprocessingcompleted / failed Session States: pendingprocessingcompleted / failed

Available Endpoints

  • POST /v1/batch-sessions - Create batch sessions
  • GET /v1/batch-sessions/{batch_id} - Get batch status
Additional endpoints for listing, canceling, and retrying batches are planned for future releases.

Limits

  • Maximum batch size: 1,000 sessions
  • Session lifetime: Up to 24 hours
  • Large batches may take several minutes to provision