SnapAPI/sdk/python

SnapAPI Python SDK

Official Python client for SnapAPI — the EU-hosted screenshot API.

Zero dependencies. Uses only Python standard library (urllib).

Installation

pip install snapapi

Quick Start

from snapapi import SnapAPI

snap = SnapAPI("your-api-key")

# Capture a screenshot
screenshot = snap.capture("https://example.com")

with open("screenshot.png", "wb") as f:
    f.write(screenshot)

Usage

Basic Screenshot

png = snap.capture("https://example.com")

With Options

jpg = snap.capture(
    "https://example.com",
    format="jpeg",
    width=1920,
    height=1080,
    quality=90,
)

Full-Page Capture

full = snap.capture(
    "https://example.com/blog",
    full_page=True,
    device_scale=2,  # Retina
)

Mobile Viewport

mobile = snap.capture(
    "https://example.com",
    width=375,
    height=812,
    device_scale=2,
)

Wait for Dynamic Content

screenshot = snap.capture(
    "https://example.com/dashboard",
    wait_for_selector="#chart-loaded",
    wait_until="networkidle2",
)

Error Handling

from snapapi import SnapAPI, SnapAPIError

snap = SnapAPI("your-api-key")

try:
    screenshot = snap.capture("https://example.com")
except SnapAPIError as e:
    print(f"API error {e.status}: {e.detail}")

API Reference

SnapAPI(api_key, base_url="https://snapapi.eu", timeout=30)

snap.capture(url, **options) -> bytes

Option	Type	Default	Description
url	str	—	URL to capture (required)
format	str	"png"	Output: png, jpeg, webp
width	int	1280	Viewport width (320–3840)
height	int	800	Viewport height (200–2160)
full_page	bool	False	Capture full page
quality	int	80	JPEG/WebP quality (1–100)
wait_for_selector	str	—	CSS selector to wait for
device_scale	float	1	Device pixel ratio (1–3)
delay	int	0	Extra delay in ms (0–5000)
wait_until	str	"domcontentloaded"	Load event

snap.health() -> dict

Returns API health status.

EU-Hosted & GDPR Compliant

SnapAPI runs entirely on EU infrastructure (Germany). Your data never leaves the EU.

License

MIT — Cloonar Technologies GmbH