# Screenshot API — Fast & Reliable Website Screenshot Service

> Markdown version of https://capture.page/screenshot-api
> Part of Capture, the web automation platform for humans and agents.
> Docs: https://docs.capture.page/docs/get-started
> Pricing: https://capture.page/pricing.md

Generate perfect website screenshots with a powerful, pay-as-you-go API.
Real-time rendering, 99.9% uptime, and edge-optimized delivery. Start free with
100 credits, no credit card required.

## Endpoint

```
GET https://api.capture.page/v1/image?token={API_KEY}&url={TARGET_URL}
```

Authentication uses an API key + secret hash. See
https://docs.capture.page/docs/get-started for the hashing scheme, or use an
official SDK.

```javascript
// Node.js SDK
import { Capture } from 'capture-node';

const capture = new Capture('your-api-key', 'your-api-secret');
const url = capture.buildImageUrl('https://example.com', {
  width: 1920,
  height: 1080,
  scaleFactor: 2,
  full: true,
});
```

## Features

- **Real-time generation** — requests are processed instantly without queues; screenshots in seconds.
- **Advanced customization** — viewport size, device emulation (150+ profiles), dark mode, element/ad blocking, custom CSS injection, wait conditions, and more.
- **Enterprise-ready** — 99.9% uptime, custom rate limits, and volume discounts; powers millions of screenshots monthly.
- **Edge-optimized delivery** — screenshots are cached and served from edge locations worldwide to cut latency and cost.
- **Formats** — PNG, JPEG, WebP, and auto-detect; transparent background supported.

## Common options

- `url` (required) — target website URL, URL-encoded
- `vw`, `vh` — viewport width/height (default 1440 x 900)
- `scaleFactor` — screen scale factor (default 1)
- `full` — capture full page (default false)
- `delay` — seconds to wait before capturing
- `waitFor` / `waitForId` — wait for a CSS selector / element ID
- `type` — png, jpeg, webp (default png)
- `transparent` — transparent background
- `emulateDevice` — device key (e.g. `iphone_13`, `ipad_pro`)
- `darkMode`, `blockCookieBanners`, `blockAds`, `bypassBotDetection`
- `selector` / `selectorId` — capture a specific element

Full parameter reference: https://capture.page/llms.txt

## Use cases

- **Visual testing** — automate visual regression testing across browsers and devices.
- **Social media cards** — generate dynamic Open Graph images and previews.
- **Website monitoring** — track visual changes and monitor competitor sites with scheduled captures.
- **Documentation** — automatically generate screenshots for docs, tutorials, and help centers.

## Pricing

1 credit per successful request; failed requests are free. Credits are shared
across all APIs and never expire. Full pricing:
https://capture.page/pricing.md

## See also

- AI agent integrations: https://capture.page/ai-agents.md
- Browser Sessions: https://capture.page/browser-sessions.md
- API overview for agents: https://capture.page/llms.txt
