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

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.

MCP Integration

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

Claude Desktop — via mcp-remote (stdio bridge)

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

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

Cursor / Windsurf — native HTTP transport

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

{
  "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:

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