Documentation

rev. 2026-04-01

Everything you need to start taking screenshots.

Authentication

Pass your API key in the X-Api-Key header on every request.

shell

Copy

curl https://api.scrnr.io/v1/screenshot
-H "X-Api-Key: sk_live_xxxx"

Endpoints

POST/v1/screenshot

Take a screenshot of any public URL.

Request body

{ "url": "https://example.com", // required "delivery": "inline" | "url", // default: inline "options": {
"width": 1280, // default: 1280, max: 1920 "height": 800, // default: 800, max: 1080 "fullPage": false, // default: false "format": "png" | "jpeg" | "webp", // default: png "waitFor": "load" | "networkidle", // default: load "delay": 0, // ms, max: 5000 "blockCookieBanners": false // default: false } }

GET/v1/usage

Returns current month usage and remaining quota for the authenticated API key.

Cookie Banner Bypass

Set options.blockCookieBanners: true to suppress GDPR/consent overlays before the screenshot is captured.

Copy

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

No technique covers 100% of sites. For best results combine with waitFor: "networkidle" and a small delay.

MCP Integration

Add scrnr as an MCP server to use take_screenshot and get_usage directly inside your AI tool.

Sign in with your scrnr account

MCP clients that support OAuth (Claude Desktop, Claude.ai connectors, Cursor, Windsurf, etc.) can connect with no API key — they'll open a browser to sign you in and request access. Just paste the URL below; we'll do the rest. If your client doesn't support OAuth yet, the API key examples further down still work.

Claude Desktop / Claude.ai — OAuth, recommended

Settings → Connectors → Add custom connector

Copy

https://mcp.scrnr.io/mcp

Cursor / Windsurf — OAuth, recommended

~/.cursor/mcp.json · ~/.codeium/windsurf/mcp_config.json

Copy

{ "mcpServers": { "scrnr": { "url": "https://mcp.scrnr.io/mcp" } } }

Or use an API key

Claude Desktop — via mcp-remote (stdio bridge)

~/Library/Application Support/Claude/claude_desktop_config.json

Copy

{ "mcpServers": { "scrnr": { "command": "npx", "args": [ "mcp-remote", "https://mcp.scrnr.io/mcp", "--header", "Authorization: Bearer sk_live_xxxx" ] } } }

Cursor / Windsurf — native HTTP transport

Copy

{ "mcpServers": { "scrnr": { "url": "https://mcp.scrnr.io/mcp", "headers": { "Authorization": "Bearer sk_live_xxxx" } } } }

Limits (Free Tier)

Limit	Value
Screenshots / month	100
Max viewport	1920 × 1080
URL delivery TTL	24 hours
API keys per account	2
Max delay	5 seconds
Request timeout	30 seconds

Quickstart

Get a screenshot in under a minute:

1. 1Sign in — Go to /dashboard and sign in with your email.
2. 2Create an API key — Click “New API key” — copy it immediately, it’s shown only once.
3. 3Make your first request — Use the POST /v1/screenshot endpoint with your key in the X-Api-Key header.