API Documentation

Everything you need to integrate SnapRender into your application.

Authentication

Pass your API key via the x-api-key header or Authorization: Bearer <key>.

curl -H "x-api-key: sr_live_YOUR_KEY" https://api.snaprender.dev/v1/...

Endpoints

POST/v1/screenshot

Capture a screenshot of any URL or raw HTML as PNG/JPEG.

Parameters

urlstringURL to screenshot (required if html not provided)
htmlstringRaw HTML to render (required if url not provided)
formatstring"png" (default) or "jpeg"
widthnumberViewport width in px (default: 1280)
heightnumberViewport height in px (default: 720)
full_pagebooleanCapture full page scroll (default: false)
qualitynumberJPEG quality 0-100 (default: 80)

Response

Binary image (image/png or image/jpeg)

Error Codes

CodeMeaning
400Bad request — missing or invalid parameters
401Unauthorized — invalid or missing API key
429Rate limit exceeded or monthly quota reached (free plan)
500Server error — rendering failed (timeout, invalid URL, etc.)

Rate Limits

  • Global: 100 requests/minute per IP
  • Free plan: 100 requests/month (hard limit)
  • Paid plans: Monthly allocation + overage at per-request rate
  • Concurrency: 4 simultaneous renders max