- name
- snap
- description
- Give your agent the ability to instantly take screenshots of any website with just the URL. Cloud-based so your agent has to perform no work. Free forever, open source.
- metadata
- author
- Kav-K
- version
- 1.0
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.pngThat'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.jpgPython 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)