# Screenshot API

> POST a public URL to https://render.cuelark.com/v1/screenshot and get a PNG, JPEG or WebP of the page from real Chromium, at any viewport size or full page.

URL: https://render.cuelark.com/screenshot-api

## Request
```bash
curl -X POST https://render.cuelark.com/v1/screenshot \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","width":1280,"height":800,"format":"png"}' \
  -o shot.png
```

## Options
| Field | Values | Default |
|---|---|---|
| url or html | public http(s) URL or HTML up to 2 MB | - |
| width, height | 320-1920, 240-1600 | 1280 × 800 |
| fullPage | true / false | false |
| format | png, jpeg, webp | png |
| quality | 30-100 (jpeg/webp) | 82 |
| retina | true for 2x pixels | false |
| javascript | false to disable scripts | true |

## Common uses
- Link previews and thumbnails for a directory or bookmarks app
- Visual checks of your own site after a deploy
- Screenshots for AI agents through the MCP server
- Archiving how a page looked on a date

## FAQ
### How long does a screenshot take?
Usually 2 to 5 seconds, depending on the page. Pages get 15 seconds to load.

### Can it screenshot pages behind a login?
No. The browser isn't signed in to anything, and cookies or credentials can't be passed in.

### Is there a free tier?
10 renders per day per IP without a key. Free API keys with 100 a month are coming with Cuelark accounts.