Updated the official Python SDK

Fixed shared options and metadata results, unified API errors, and synchronized option helpers with the screenshot API documentation.

Changelog1 min read

Written by

Dmytro Krasun

Published on

Version 0.0.17 of the official Python SDK fixes correctness issues and synchronizes its option helpers with the screenshot API option reference.

The update fixes three areas:

  • Independent options. Each TakeOptions instance now keeps its own options. Creating a second request no longer changes the URL, format, or other options of the first. Generating a URL or sending a request also leaves the caller’s options unchanged.
  • Working metadata results. take_with_metadata() now returns the screenshot stream and vision metadata when present, instead of failing while constructing the result.
  • Consistent API errors. InvalidRequestException now inherits from APIErrorException, so you can catch both with one handler. Non-JSON error responses also raise an SDK exception.

We added missing option helpers, including PDF margins, full-page slices, shadow DOM, motion reduction, hover actions, proxy bypass hosts, webhook errors, and request and content failure checks. Use .async_option(True) for the API’s async option and pass lists for repeated options such as .proxy_bypass_hosts(["cdn.example.com"]).

The SDK also has regression tests, CI checks across Python versions, and an updated README with links to Python tutorials.

See the Python SDK documentation for usage examples and the SDK README for error handling and useful resources.

If you have any questions or suggestions, please contact support@screenshotone.com.

Read more product updates

New features, bug fixes, and optimizations...

View all product updates
Stop scrolling screenshots when a given selector is visible

Stop scrolling screenshots when a given selector is visible

New options were added to the ScreenshotOne API to stop scrolling screenshots when a given selector is reached.

Read more

1 min read

Improved banner blocking and stealth mode for more websites

Improved banner blocking and stealth mode for more websites

Another round of rendering improvements for websites with banners, popups, and improving stealth mode for more websites.

Read more

1 min read

Add ScreenshotOne to n8n workflows

Add ScreenshotOne to n8n workflows

You can now use ScreenshotOne in n8n workflows to render website screenshots, PDFs, scrolling screenshots and videos.

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.