Screenshot URL

Danger

Screenshot URLs are temporary. Download files promptly and do not rely on these URLs for long-term storage.

For cached results, cache_ttl controls result reuse, not URL deletion. A URL may remain accessible beyond the TTL.

Note

For long-term screenshot or video archival, consider uploading them to any compatible S3-storage.

Successful synchronous response_type=json requests for animated/scrolling screenshots or regular screenshots include a screenshot URL:

{
    "screenshot_url": "..."
}

Use screenshot_url for downloads, even if cache_url is missing. Cached results reuse their URL, but each new render gets a new one. If no screenshot URL can be provided, the request returns an error.

Also, when using webhooks and if you do not upload the screenshot to any S3-compatible storage, you will get the URL in the webhook request body,too.