Screenshot API Documentation

Capture pixel-perfect screenshots of any website with a simple REST API call. Get started in under 5 minutes with our free tier.

Quick Start

The fastest way to capture a screenshot:

This returns a PNG image of the website. No API key required for testing (rate limited).

Authentication

Include your API key in the X-API-Key header:

curl -H "X-API-Key: your-api-key" \
  "https://benit.uk/api/screenshot?url=https://example.com"

Get your free API key by signing up.

Endpoints

Capture Screenshot

Captures a screenshot of the specified URL.

Examples

Mobile Screenshot

curl "https://benit.uk/api/screenshot?url=https://example.com&viewport=mobile" \
  -o mobile-screenshot.png

Full Page Capture

curl "https://benit.uk/api/screenshot?url=https://example.com&fullPage=true" \
  -o fullpage.png

Custom Viewport

curl "https://benit.uk/api/screenshot?url=https://example.com&width=1200&height=800" \
  -o custom.png

Wait for Dynamic Content

curl "https://benit.uk/api/screenshot?url=https://example.com&waitForSelector=.loaded-content" \
  -o loaded.png

Rate Limits

Error Handling

The API returns standard HTTP status codes:

SDK & Libraries

Official SDKs coming soon. For now, use any HTTP client:

JavaScript (Fetch)

const response = await fetch(
  'https://benit.uk/api/screenshot?url=https://example.com',
  { headers: { 'X-API-Key': 'your-api-key' } }
);
const blob = await response.blob();
// Use blob as image

Python (Requests)

import requests

response = requests.get(
    'https://benit.uk/api/screenshot',
    params={'url': 'https://example.com'},
    headers={'X-API-Key': 'your-api-key'}
)

with open('screenshot.png', 'wb') as f:
    f.write(response.content)

Use Cases

Website Monitoring

Automate visual checks of your websites. Capture scheduled screenshots to detect layout issues.

Social Media Previews

Generate Open Graph images and social sharing thumbnails for your content.

Documentation

Automatically capture screenshots for documentation, tutorials, and changelogs.

Testing

Integrate visual regression testing into your CI/CD pipeline.