screenshotone

What it is and what it does

screenshotone is an official Python client for ScreenshotOne.com's screenshot and rendering API. It wraps HTTP calls to a remote service that captures web pages as images or PDFs, letting you configure viewport dimensions, block cookie banners and chat widgets, and choose output formats. The SDK handles URL generation and image download, plus structured error handling for API failures.

You provide your ScreenshotOne API credentials, build options using a fluent interface (TakeOptions), and either generate a signed URL to share or call take() to download the image directly. It depends only on requests and requires Python 3.7+. The package is straightforward but entirely dependent on the availability and reliability of the ScreenshotOne service itself.

Use it for:

• Capture live website screenshots for automated visual testing or regression detection.
• Generate preview images of user-submitted URLs for display in a web application.
• Batch-render HTML templates as PNG or PDF files for reports or email attachments.
• Create thumbnail previews of web pages for link sharing or archival systems.
• Automate screenshot collection for accessibility audits or visual documentation.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python SDK for the ScreenshotOne.com API that takes screenshots of URLs, renders HTML as images, and generates PDFs through a remote service.

Yes, if you already use or plan to subscribe to ScreenshotOne.com. The SDK is straightforward, has no security vulnerabilities, and low install friction. However, the aging maintenance status (513 days since last release) and dependency on a third-party paid service mean you should verify the service's current reliability and pricing before committing. Not suitable if you need a self-hosted or free screenshot solution.

Install

screenshotone on PyPI

pip install screenshotone

uv add screenshotone

poetry add screenshotone

Installing screenshotone

Before you install

Low install friction with a single runtime dependency (requests). Maintenance status is aging—last release was 513 days ago—so expect slower response to issues, though the package remains functional for its stated purpose.

License in practice

Released under the MIT license (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart

pip install screenshotone

from screenshotone import Client, TakeOptions

client = Client('your_access_key', 'your_secret_key')
options = TakeOptions.url('https://example.com').format('png')
image = client.take(options)
with open('screenshot.png', 'wb') as f:
    f.write(image.read())

Requires valid ScreenshotOne.com API credentials (access_key and secret_key) and an active subscription to the service.

Verify before relying

• Whether the ScreenshotOne.com service remains actively maintained and reliable for production use.
• Current API rate limits, pricing tier requirements, and whether free tier access is still available.
• Whether the SDK's latest version fully supports all current ScreenshotOne API options.

Package facts

Evidence: screenshotone-0.0.16-py3-none-any.whl

Tags

More WWW/HTTP packages