---
title: "Batch content"
method: POST
path: "/browser/batches"
---

# Batch content

`POST /browser/batches`

Queue multiple web requests for later retrieval.

## Request body

- object
  - `urls` string[], required — The URLs of the pages to browse.
  - `difficulty` 'low' | 'medium' | 'high' — The difficulty pool to attempt to access the URLs from.
  - `speed` 'light' | 'ridiculous' | 'ludicrous (planned)' — The speed to attempt to access the URLs at, where `ridiculous` is 30 percent faster on average than `light` speed.
  - `device` string — The name as returned by the [devices resource](devices) of the device to emulate browsing on (these names are case insensitive); device emulation is unused by default.
  - `country` string — The [two-letter ISO code](https://www.iso.org/obp/ui/#search/code) of the country to browse from (these codes are case insensitive); a random country is used by default.
  - `subdivision` string — The alphanumeric second part (proceeding the separator) of a [first-level subdivision code](https://www.iso.org/obp/ui/#search/code) in the (prerequisite) country to browse from (these codes are case insensitive); a random subdivision is used by default.
  - `city` string — The [commonly spelled name](https://www.geonames.org/) of the city in the (prerequisite) country to browse from (these names are temporarily case sensitive); a random city is used by default.
  - `captcha` 'solved' | 'ignored' | 'rejected' — The intended resolution of any detected captcha, where `rejected` results in a `403` response.
  - `readiness` 'load' | 'domcontentloaded' — The standard ready event to await before snapshotting browsed content.
  - `delay` number — The number of supplemental seconds to delay before snapshotting browsed content; no delay is used by default.
  - `format` 'rendered' | 'raw' | 'markdown' — The format to output to.
  - `expiration` integer — The age in days of when to consider cached content expired, where `0` disables caching.
  - `callback` string — The HTTP or HTTPS callback URL or Amazon SQS queue URL or ARN to notify when the batch content has been retrieved; any SQS queue must grant `sqs:SendMessage` permission to the `arn:aws:iam::180363035301:role/api-instance` AWS principal.

## Response `202`

A job identifier and confirmation count.

- object
  - `id` string, uuid, required — The identifier to retrieve the batch content with.
  - `count` integer, required — The number of requests in the batch as confirmed by the API.

## Other responses

- `401` — The authorization header was missing.
- `402` — No more credits are available.
- `403` — The API token was invalid.
- `422` — One or more parameters were invalid.
- `500` — An unknown error occurred.

## Changes

- **2026-07-06** `bfddf5b2c698` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/joinmassive/apis/massive/changes/browser/batches/post.md)

---

[API](https://skmtc.dev/joinmassive/apis/massive.md) · [All operations](https://skmtc.dev/joinmassive/apis/massive/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinmassive/massive/revisions/3a9f7769563f/schema)