New FeatureMarch 8, 2026
Flexible response formats
You can now choose exactly how you want to receive your screenshots. The new responseType parameter works the same way on both sync and async endpoints, giving you full control over the response format.
Three response formats
binary(default) — Raw image bytes with the content type header. Perfect for piping directly to a file.base64— JSON response with base64-encoded image data. Ideal for embedding in HTML, emails, or passing to other APIs without dealing with binary streams.url— Stores the image on our CDN and returns a JSON response with a direct download URL. Great when you need a shareable link or want to defer downloading.
Example
{
"url": "https://example.com",
"responseType": "url"
}Response:
{
"url": "https://example.com",
"format": "png",
"contentType": "image/png",
"width": 1920,
"height": 1080,
"size": 245678,
"renderTimeMs": 1234,
"storageUrl": "https://storage.allscreenshots.com/abc123.png",
"expiresAt": "2026-03-15T12:00:00Z"
}Consistent across endpoints
The responseType parameter now works identically on sync (POST /v1/screenshots) and async (POST /v1/screenshots/async) endpoints, including multi-output requests. The dashboard workbench also has a new response type selector in the output settings.
See the screenshots API reference for the full response schema for each format.