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
Improved design of the authentication pages

Improved design of the authentication pages

We updated the design of the authentication pages to make them more user-friendly and consistent.

Read more

1 min read

Screenshot URL in webhooks

Screenshot URL in webhooks

Now, you can get the screenshot URL in the webhook response.

Read more

1 min read

Change organization owner for already subscribed customers

Change organization owner for already subscribed customers

Starting today, you can change organization owner for already subscribed customers.

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.