Create a batch screenshot job

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.

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

Request body

urlsstring[] required

Array of URLs to capture (1-50)

format'png' | 'jpeg' | 'webp' | 'pdf'
widthinteger
heightinteger
full_pageboolean
qualityinteger
delayinteger
dark_modeboolean
block_adsboolean
block_cookie_bannersboolean
hide_selectorsstring
click_selectorstring
device'iphone_14' | 'iphone_15_pro' | 'pixel_7' | 'ipad_pro' | 'macbook_pro'
user_agentstring

Response

Batch job created

jobIdstring uuid

Unique batch job identifier

status'pending' | 'processing' | 'completed' | 'failed'

Overall job status

statusUrlstring

URL to poll for status updates

totalinteger

Total number of URLs in the batch

completedinteger

Number of successfully completed screenshots

failedinteger

Number of failed screenshots

createdAtstring date-time
completedAtstring date-time

Present when job is completed or failed

Changes

No recorded changes to this operation across all 1 revision of this API.