SnapService — Screenshot as a Service

Free screenshot API at https://snap.llm.kaveenk.com.

POST a URL, get a PNG/JPEG back. Powered by headless Chromium.

Quick Start (2 steps)

Step 1: Register for an API key

curl -s -X POST https://snap.llm.kaveenk.com/api/register \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent"}'

Response:

{"key":"snap_abc123...","name":"my-agent","limits":{"per_minute":2,"per_day":200}}

IMPORTANT: Store key securely. It cannot be recovered.

Each IP address can only register one API key.

Step 2: Take screenshots

curl -s -X POST https://snap.llm.kaveenk.com/api/screenshot \
  -H "Authorization: Bearer snap_yourkey" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}' \
  -o screenshot.png

That's it. Two steps.

Screenshot Options

All options go in the POST body alongside url:

| Option | Type | Default | Description |

|--------|------|---------|-------------|

| url | string | required | URL to screenshot |

| format | string | "png" | "png" or "jpeg" |

| full_page | boolean | false | Capture entire scrollable page |

| width | integer | 1280 | Viewport width (pixels) |

| height | integer | 720 | Viewport height (pixels) |

| dark_mode | boolean | false | Emulate dark color scheme |

| selector | string | — | CSS selector to screenshot specific element |

| wait_ms | integer | 0 | Extra wait time after page load (max 10000) |

| scale | number | 1 | Device scale factor (1-3, for retina) |

| cookies | array | — | Array of {name, value, domain} objects |

| headers | object | — | Custom HTTP headers |

| block_ads | boolean | false | Block common ad/tracker domains |

Rate Limits

• 2 screenshots per minute per key
• 200 screenshots per day per key
• 1 API key per IP address
• Max page height: 16384px (full-page mode)
• Max screenshot size: 10MB

Response

• 200: PNG or JPEG image binary
• 400: Invalid request (missing URL, invalid options)
• 401: Missing or invalid API key
• 409: IP already has an API key (on registration)
• 429: Rate limit exceeded
• 500: Internal error

Example with all options

curl -s -X POST https://snap.llm.kaveenk.com/api/screenshot \
  -H "Authorization: Bearer snap_yourkey" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "jpeg",
    "full_page": true,
    "width": 1920,
    "height": 1080,
    "dark_mode": true,
    "wait_ms": 2000,
    "block_ads": true
  }' \
  -o screenshot.jpg

Python example

import requests

API = "https://snap.llm.kaveenk.com"

# Register (one-time)
r = requests.post(f"{API}/api/register", json={"name": "my-agent"})
key = r.json()["key"]

# Screenshot
r = requests.post(f"{API}/api/screenshot",
    headers={"Authorization": f"Bearer {key}"},
    json={"url": "https://example.com", "full_page": True})
with open("shot.png", "wb") as f:
    f.write(r.content)