Full-page or viewport capture of any public URL with device presets. The simple front door agents search for: no browser pool to run, no Puppeteer to maintain.
Get a key first – no signup: curl -X POST https://api.bigapi.dev/v1/keys (100 free operations, 7 days).
curl -X POST https://api.bigapi.dev/v1/screenshot -H 'Authorization: Bearer $KEY' -H 'Content-Type: application/json' -d '{"url":"https://example.com","device":"mobile"}' -o shot.png
Add BiGapi to Claude Desktop, Cursor or any MCP client – the server fetches its own key on first use:
{
"mcpServers": {
"bigapi": { "command": "npx", "args": ["-y", "@bigapi/mcp"] }
}
}
Then simply ask: “Take a mobile screenshot of bigapi.dev and show it to me.” – the model calls the screenshot tool.
| Param | Type | Required | Notes |
|---|---|---|---|
url | string | yes | Public URL to capture. |
device | string | no | Viewport preset; mobile/tablet use touch + high DPI. – one of desktop, laptop, tablet, mobile · default desktop |
fullPage | boolean | no | Capture the whole page instead of just the viewport. – default True |
format | string | no | one of png, jpeg · default png |
quality | integer | no | JPEG quality 30–100. – default 85 |
width | integer | no | Override viewport width (px). |
height | integer | no | Override viewport height (px). |
delayMs | integer | no | Extra wait after load, up to 10000 ms. |
Idempotency-Key are free · prepaid credit from $5, never expires.Every response carries X-BigAPI-Cost, X-BigAPI-Balance and X-BigAPI-Free-Ops – your agent can budget on its own.
| Status | Meaning | Agent action |
|---|---|---|
401 | missing/invalid key | POST /v1/keys for a fresh one |
402 | credit exhausted | show the upgrade_url from the response to a human |
413 | file too large | split the input (limit 100 MB) |
422 | conversion failed | check the detail field – costs $0 |
429 | rate limited | wait retry_after seconds |
desktop (1440×900), laptop (1280×800), tablet (834×1112 @2x) and mobile (390×844 @3x, touch enabled). Override width/height freely.
fullPage=true (default) captures the whole scroll height; set false for the viewport only.
PNG by default. format=jpeg with quality 30–100 for smaller files.