Better failure and timeout handling

Requests fail within 90 seconds instead of retrying for minutes, and every API error is returned as JSON.

Changelog1 min read

Written by

Dmytro Krasun

Published on

When our rendering servers were unavailable or slow, the API could retry a request on several servers, each time with a new time limit, so a request could take several minutes before failing.

Now the API waits at most 90 seconds in total for its rendering servers, including any retry on another server:

  • Requests fail sooner. Some requests that used to succeed after long retries now fail with an error instead. Retrying such a request later is safe.
  • Timeouts are no longer retried. If a rendering server times out, the request fails, because the render may still be running and a retry would render the screenshot twice. This includes GPU rendering: without fail_if_gpu_rendering_fails, the request falls back to CPU rendering only when the GPU servers are unavailable and enough time is left.
  • Large files aren’t cut off. The limit covers waiting for the rendering servers, not transferring the result, so a large PDF or video can finish downloading after it.

Errors are also more consistent:

  • Every error the API returns is JSON with error_code, error_message and documentation_url, as described in the errors documentation, including when a rendering server is unavailable.

See the timeout option.

Read more product updates

New features, bug fixes, and optimizations...

View all product updates
Choose the full page screenshot algorithm

Choose the full page screenshot algorithm

Now, you can choose the full page screenshot algorithm.

Read more

1 min read

ScreenshotOne is now integrated into Summit

ScreenshotOne is now integrated into Summit

The ScreenshotOne screenshot API is now natively integrated into Summit and you can perform anything on top of the powerful screenshot automation and Summit models—only the sky is the limit.

Read more

1 min read

Extract Open Graph metadata while rendering screenshots

Extract Open Graph metadata while rendering screenshots

From today, you can get parsed Open Graph metadata and screenshots in one API request.

Read more

1 min read

Automate website screenshots

Exhaustive documentation, ready SDKs, no-code tools, and other automation to help you render website screenshots and outsource all the boring work related to that to us.