---
title: "Create a batch screenshot job"
method: POST
path: "/v1/screenshot/batch"
---

# Create a batch screenshot job

`POST /v1/screenshot/batch`

## Request

- Base URL: `https://app.snap-render.com`
- URL: `https://app.snap-render.com/v1/screenshot/batch`
- Auth: API key in header `X-API-Key`

Submit up to 50 URLs for batch screenshot processing. Returns immediately with a job ID. Poll GET /v1/screenshot/batch/{jobId} for results. Each URL consumes one credit; failed URLs get credits rolled back automatically.

## Request body

- object
  - `urls` string[], required: Array of URLs to capture (1-50)
  - `format` 'png' | 'jpeg' | 'webp' | 'pdf'
  - `width` integer
  - `height` integer
  - `full_page` boolean
  - `quality` integer
  - `delay` integer
  - `dark_mode` boolean
  - `block_ads` boolean
  - `block_cookie_banners` boolean
  - `hide_selectors` string
  - `click_selector` string
  - `device` 'iphone_14' | 'iphone_15_pro' | 'pixel_7' | 'ipad_pro' | 'macbook_pro'
  - `user_agent` string

## Response `202`

Batch job created

- BatchJobResponse
  - `jobId` string, uuid: Unique batch job identifier
  - `status` 'pending' | 'processing' | 'completed' | 'failed': Overall job status
  - `statusUrl` string: URL to poll for status updates
  - `total` integer: Total number of URLs in the batch
  - `completed` integer: Number of successfully completed screenshots
  - `failed` integer: Number of failed screenshots
  - `items` object[]
    - `url` string: The URL that was captured
    - `status` 'pending' | 'completed' | 'failed'
    - `downloadUrl` string: Presigned download URL (24h validity, present when completed)
    - `error` string: Error message (present when failed)
  - `createdAt` string, date-time
  - `completedAt` string, date-time: Present when job is completed or failed

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `429`: Rate limited or quota exceeded

---

[API](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api.md) · [All operations](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/revisions/420ff88deeb2?raw)