Skip to main content
POST
SERP Batch

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
inputs
object[]
required

Array of SERP requests. Each object can include search parameters and async/storage settings.

Minimum array length: 1
shared_inputs
object

Shared parameters applied to the entire batch. Can include search parameters and async/storage settings.

Response

200 - application/json

Batch created successfully

Response when a batch of SERP tasks is created successfully.

batch_id
string
required

Unique identifier for the batch.

batch_size
number
required

Number of tasks in the batch.

tasks
object[]
required

List of created tasks.