There is an official Python SDK on PyPI (getsnap). It wraps the same REST endpoint and returns the parsed JSON, so you can drop down to requests at any point without changing anything server-side.

Install

pip install getsnap

Your first screenshot in Python

One POST, one JSON body, one URL back. The response is a CDN link to the finished image.

Python SDK

from getsnap import GetSnap

snap = GetSnap("sk_live_YOUR_KEY")

result = snap.screenshot(url="https://github.com", format="png")
print(result["url"])   # CDN URL to your screenshot

requests (no SDK)

import requests

resp = requests.post(
    "https://api.getsnap.dev/v1/screenshot",
    headers={"X-API-Key": "sk_live_YOUR_KEY"},
    json={"url": "https://github.com", "format": "png"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json()["url"])

Full-page captures and other options

Every option is a field in the same JSON body. The common ones are full-page capture, popup and ad removal, viewport size, and lazy-load scrolling.

result = snap.screenshot(
    url="https://example.com",
    format="png",
    full_page=True,       # capture past the fold
    remove_popups=True,   # dismiss cookie banners and modals
    block_ads=True,
    lazy_load=True,       # auto-scroll so lazy images load
    extract_text=True,    # also return the page text
)
print(result["url"])
print(result["extracted_text"])

Saving the image to disk

By default you get a CDN URL. Ask for a binary response instead and you get the bytes directly, which saves a round-trip when you are storing the file yourself.

# Skip the CDN round-trip and get the bytes directly
data = snap.screenshot_binary(url="https://example.com", format="webp", quality=90)
with open("screenshot.webp", "wb") as f:
    f.write(data)

Handling errors

Every failure returns JSON with an error code and a human-readable message. These are the ones worth branching on:

Status	error	What it means
400	validation_error	A field is missing or out of range. The body names the field.
401	unauthorized	Missing or unknown API key.
402	quota_exceeded	Monthly capture limit reached.
429	rate_limit_exceeded	Too many requests this minute. Back off and retry.
500	capture_failed	The page could not be rendered - usually a timeout on a page that never settles.

import requests

try:
    resp = requests.post(
        "https://api.getsnap.dev/v1/screenshot",
        headers={"X-API-Key": "sk_live_YOUR_KEY"},
        json={"url": "https://example.com"},
        timeout=60,
    )
    resp.raise_for_status()
    print(resp.json()["url"])
except requests.HTTPError as e:
    body = e.response.json()
    # e.g. {"error": "quota_exceeded", "message": "..."}
    print(e.response.status_code, body.get("error"), body.get("message"))

Rate limits and quotas

Plan	Captures / month	Requests / minute
Free	100	5
Starter	5,000	30
Pro	25,000	60
Business	100,000	120

Exceeding the per-minute limit returns 429; exceeding the monthly quota returns 402. See pricing for the full breakdown.

Frequently asked questions

Next steps

• Code examples — every feature, with cURL, Node.js and Python tabs
• API reference — every request field and response shape
• Playground — try a capture in the browser before writing any Python
• Pricing — plans, quotas and overage

Related reading

• Dynamic OG images in Python — a complete worked example
• Screenshots for GPT-4V, Claude and Gemini — cutting vision-model token costs