Page Rendering
Screenshot
Render a full-page screenshot of any URL as PNG, WebP, or JPEG.
POST
Captures a full-page screenshot with headless Chromium: navigates to the URL, waits for the network to settle, scrolls to trigger lazy-loaded content and reveal animations, then encodes the result. The finished image is written to temporary storage and its filename returned — fetch the actual bytes from the download path described below.
2 credits per call · Typical response time ~310ms
Body parameters
The page to capture.
https:// is assumed if the scheme is omitted.Output image format:
png, jpeg, or webp.Viewport to render at:
desktop or mobile.Emulated
prefers-color-scheme while rendering: light or dark. Affects any site that themes off this media query.Response
Name of the generated file. Download it from
/api/uploads/<filename> on the same host — the file is temporary and removed after roughly 5 minutes.Size of the encoded image.
Echoes the requested
format.File extension for the download (
jpg for the jpeg format, otherwise matches format).true if the page was taller than the capture cap and the image was clipped rather than capturing the full height.Total server-side time for the capture.
Response headers
In addition to the standard headers, this endpoint sends:HIT if served from the short-lived result cache without touching Chrome, otherwise MISS.Mirrors
clipped in the body.Per-stage breakdown (
queue, page, nav, net, scroll, settle, encode, total, all in ms) — renders as a waterfall in your browser’s devtools Network panel.Errors
See the full error reference for the platform-level codes (
401, 402, 429) that apply to every endpoint.