Screenshots

Try it live: URL to Screenshot

Basic usage

Capture a webpage screenshot:

curl -X POST https://api.orim.io/snap/capture \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}' \
  -o screenshot.png

Viewport size

Default viewport is 1920x1080. Customize with width and height:

{
  "url": "https://example.com",
  "width": 1280,
  "height": 720
}

Note: height is ignored when full_page is enabled.

Image format

Supported formats: png (default), jpeg, webp

{
  "url": "https://example.com",
  "format": "jpeg",
  "quality": 80
}

Full page capture

Capture the entire scrollable page:

{
  "url": "https://example.com",
  "full_page": true
}

Locale

Set browser locale for localized content:

{
  "url": "https://example.com",
  "locale": "fr-FR"
}

Wait for content

The API automatically waits for:

• Network idle
• Lazy-loaded images (up to 3 seconds)

Limitations

Limit	Value
Max viewport	4096×4096
Timeout	30 seconds
Private URLs	Blocked (SSRF protection)
Auth-required pages	Not supported

SSRF Protection

For security, the following are blocked:

• localhost, 127.0.0.1
• Private IP ranges (10.x, 172.16.x, 192.168.x)
• Internal hostnames