# ScreenshotEngine

> Fast & clean API for pixel-perfect website screenshots. Queue-less captures with support for WebP, PNG, JPEG, PDF, and scrolling website video. Block cookie banners, dark mode, and device emulation built-in.

## API
- [API Documentation](https://www.screenshotengine.com/docs): Developer guides and API reference
- [Full Documentation](https://www.screenshotengine.com/llms-full.txt): Complete developer documentation in plain text
- [Screenshot API quickstart](https://www.screenshotengine.com/docs/quickstart): Make your first ScreenshotEngine API request with cURL. Get an API key, capture a full-page PNG, and save the binary response.
- [API keys and authentication](https://www.screenshotengine.com/docs/authentication): Authenticate ScreenshotEngine GET and POST requests, store API keys securely, and understand the difference between query and Bearer authentication.
- [Screenshot API parameter reference](https://www.screenshotengine.com/docs/parameters): Compare GET and POST options for screenshots, PDF, WebM video, viewport sizes, CSS selectors, delays, watermarking, and cache control.
- [Screenshot API examples in Node.js, Python, and PHP](https://www.screenshotengine.com/docs/code-examples): Copy server-side ScreenshotEngine examples for Node.js, Python, PHP, and cURL, with API key environment variables and binary file handling.
- [Full-page, mobile, PDF, and video screenshot recipes](https://www.screenshotengine.com/docs/capture-recipes): Practical ScreenshotEngine requests for full-page and mobile screenshots, CSS elements, dark mode, cookie banners, PDF, WebM video, and watermarks.
- [Evergreen screenshots: auto-updating image URLs](https://www.screenshotengine.com/docs/evergreen-screenshots): Create a website screenshot with a fixed image URL that refreshes daily or weekly. Embed it once and ScreenshotEngine keeps the image current.
- [Screenshot caching and fresh captures](https://www.screenshotengine.com/docs/caching): Understand ScreenshotEngine cache behavior, X-Cache response headers, successful-request usage, and the POST no-cache option for fresh screenshots.
- [Screenshot API errors, rate limits, and troubleshooting](https://www.screenshotengine.com/docs/errors-and-limits): Resolve ScreenshotEngine HTTP 400, 401, 429, 500, and 503 errors. Understand monthly quotas, retry behavior, blank captures, and output files.
- [OpenAPI Spec](https://www.screenshotengine.com/openapi.json): Machine-readable OpenAPI 3.0 spec
- Base URL: https://api.screenshotengine.com
- Endpoint: GET or POST /v1/screenshot
- POST: Authorization: Bearer YOUR_API_KEY; Content-Type: application/json; body contains url and capture options
- GET: url and api_key query parameters; snake_case option names
- POST uses camelCase option names, including blockBanners, darkMode, viewportDevice, waitFor, and cachePolicy
- HTTP 200 returns raw file bytes; errors return JSON
- POST cachePolicy: "no-cache" bypasses cache reads and writes; successful cache hits count toward usage
- Evergreen screenshots: POST /v1/evergreen-screenshot takes the POST /v1/screenshot body plus schedule ("daily" or "weekly") and returns JSON with a fixed imageUrl that is re-captured on schedule; manage with GET, PATCH, DELETE /v1/evergreen-screenshot/{id} and POST /v1/evergreen-screenshot/{id}/refresh

## MCP Server (AI Agents)
- [MCP Setup Guide](https://www.screenshotengine.com/mcp): Copy-paste configs for Claude Code, Claude Desktop, Cursor, and VS Code
- MCP endpoint: https://api.screenshotengine.com/mcp (streamable HTTP; auth via "Authorization: Bearer YOUR_KEY" header or ?api_key= query param)
- Tool: take_screenshot returns inline images (JPEG/PNG/WebP) the model can see directly, or PDF resources
- Tools: create_evergreen_screenshot, list_evergreen_screenshots, delete_evergreen_screenshot manage auto-updating image URLs
- [MCP Server Card](https://www.screenshotengine.com/.well-known/mcp/server-card.json): Machine-readable server description
- MCP protocol calls (initialize, tools/list) are free; only successful captures count toward quota

## Pricing
- [Plans & Pricing](https://www.screenshotengine.com/pricing): Free tier available, pay-per-use plans
- Free (Free): 50 screenshots/month, 5 req/min, 1 evergreen screenshot, Email support
- Starter ($24/mo): 3,000 screenshots/month, 40 req/min, 25 evergreen screenshots, Email support
- Professional ($89/mo): 15,000 screenshots/month, 100 req/min, 100 evergreen screenshots, Priority support
- Engine ($299/mo): 60,000 screenshots/month, 250 req/min, 500 evergreen screenshots, Priority 24/7 support
- Pay Only for Success: failed requests are not counted toward your monthly limit

## Features
- [Evergreen Screenshot API](https://www.screenshotengine.com/features/evergreen-screenshot-api): ScreenshotEngine Evergreen Screenshot API gives a website screenshot a fixed image URL and refreshes the image on a daily or weekly schedule. Embed the URL once in your website or app. Later captures update the image without changing the link.
- [Block Cookie Banners](https://www.screenshotengine.com/features/ad-cookie-banner-removal): Remove consent dialogs automatically
- [Dark Mode](https://www.screenshotengine.com/features/dark-mode-website-screenshot-api): Emulate dark color scheme
- [Full Page Screenshots](https://www.screenshotengine.com/features/full-page-website-screenshot-api): Capture entire scrollable page
- [HTML to PDF API](https://www.screenshotengine.com/features/export-to-pdf-api): Convert any URL or webpage to PDF
- [Website to Video API](https://www.screenshotengine.com/features/website-video-screenshot): Record a smooth scrolling WebM video of any page
- [Device Emulation](https://www.screenshotengine.com/features/developer-first-screenshot-api): Emulate mobile and desktop viewports
- [Watermark](https://www.screenshotengine.com/features/website-screenshot-api-with-watermark): Add custom text watermarks
- Full Page Screenshots: Capture the entire scrollable page by passing height=full
- Element Screenshots: Capture a specific DOM element by passing a CSS selector

## Free Tools
- [Free Website Screenshot](https://www.screenshotengine.com/tools/free-website-screenshot): Screenshot any URL online and turn it into a mockup
- [Free URL to PDF Converter](https://www.screenshotengine.com/tools/url-to-pdf): Convert any webpage to PDF online, no sign-up

## About
ScreenshotEngine is a queue-less, pixel-perfect screenshot API. Send a single GET request with a URL and API key — get back an image, PDF, or scrolling video in the response. Supports full-page screenshots (height=full) and element-level screenshots by passing a CSS selector. Every plan (including Free) ships the full engine: scrolling video capture, PDF export, WebP output, custom watermarking, dark-mode emulation, and ad/cookie-banner blocking — plans differ only in volume, rate limit, and support. AI agents can connect via the hosted MCP server. No queues, no headless browser setup, no infrastructure to manage. Free tier available; paid plans are pay-per-successful-request only.