---
id: screenshotone
version: "0.0.16"
license: unclear
license_treatment: permissive
maintenance: aging
---

# screenshotone — A Python SDK for ScreenshotOne.com API to take screenshots of URLs, render HTML as images and PDF

License: permissive · Maintenance: aging · Downloads: 114.4K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 114.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

screenshot API client, URL to image conversion, web page screenshot, HTML rendering service, screenshot generation SDK, webpage capture tool, remote screenshot API, screenshot-api, web-automation

[View on SkillFed](https://skillfed.io/packages/screenshotone) · [View on PyPI](https://pypi.org/project/screenshotone/)