# Screenshot API

> A development preview for deterministic website screenshots designed for developers and tool-calling AI agents.

Canonical site: https://api-screenshot.com
Proposed API base URL: https://api-screenshot.com/v1
OpenAPI 3.1 design preview: https://api-screenshot.com/openapi.json
Human documentation preview: https://api-screenshot.com/docs
Getting started: https://api-screenshot.com/docs/getting-started
Endpoint reference: https://api-screenshot.com/docs/api-reference
Screenshot options: https://api-screenshot.com/docs/options
Error reference: https://api-screenshot.com/docs/errors
Implementation guides: https://api-screenshot.com/docs/guides
Engineering guides: https://api-screenshot.com/blog
Product FAQ: https://api-screenshot.com/faq
Complete agent bundle: https://api-screenshot.com/llms-full.txt
Launch status: private development preview. The durable control plane is implemented locally behind a disabled feature flag. Account signup, browser rendering, artifact delivery, and production traffic are not available.

## Proposed workflow

- POST /v1/screenshots to create a bounded asynchronous capture job.
- GET /v1/screenshots/{id} to inspect job state and result metadata.
- DELETE /v1/screenshots/{id} to request artifact deletion.
- GET /v1/usage to inspect metered usage.

The OpenAPI document describes the feature-gated local control plane and intended renderer contract, not a live service. Do not send production traffic or treat preview examples as availability claims.

## Safety boundary

Only HTTP and HTTPS URLs will be accepted. The renderer will block private and special-use networks, revalidate redirects, isolate Chromium workers, cap resources and page height, and store artifacts privately behind expiring signed URLs.