Website Screenshot API - Full-Page PNG of Any URL

Website Screenshot via Scavio

Give any public URL and get back a full-page PNG screenshot of the page, returned inline as a base64 data:image/png URI ready to drop into an `` tag or decode to a file. Every capture is the full page, top to bottom.

When to trigger

Use this skill when the user asks to:

• Screenshot a web page or capture a full-page image of a URL
• Grab a visual snapshot / preview / thumbnail of a website
• Turn a page into an image for a report, a slide, an email or a PDF
• Feed a rendered page to a vision model or an OCR step as a PNG
• Visually diff or archive how a page looks right now

Setup

Get a free API key at scavio.dev (50 free credits to get started, no card required):

export SCAVIO_API_KEY=sk_live_your_key

Every request is a POST with a JSON body and:

Authorization: Bearer $SCAVIO_API_KEY

Endpoints

Base URL: https://api.scavio.dev.

Parameters

Capture tiers and their cost:

Start at normal and only step up if the returned image is blank or incomplete - the higher tiers cost more and are wasted on pages that do not need them.

Scope notes

• The capture is always the full page, not just the visible viewport - long pages come back as tall images.
• The image is returned inline as a data:image/png;base64,... URI, not a hosted link. There is no URL to expire; you hold the bytes.
• Only a successful capture is billed. A page that cannot be captured (a 422) or a target that is not found (a 404) costs nothing.
• image_bytes is the size of the decoded PNG, so you can budget before decoding.

Examples

import base64
import requests

BASE = "https://api.scavio.dev"
# Your key from https://scavio.dev. Load it from your environment or secret
# store in real code - keep it out of source control.
API_KEY = "sk_your_key_here"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Capture a full-page screenshot (normal tier, 1 credit)
shot = requests.post(f"{BASE}/api/v1/extract/screenshot", headers=HEADERS,
    json={"url": "https://example.com"}).json()

data = shot["data"]
print(data["mode"], data["image_format"], data["image_bytes"], "bytes")

# 2. The image is a data:image/png;base64 URI - strip the prefix, decode it,
#    and write the PNG to disk.
b64 = data["image"].split(",", 1)[1]
with open("example.png", "wb") as f:
    f.write(base64.b64decode(b64))

# 3. A tougher, heavily protected site - step up the capture tier (ultra, 5 credits)
hard = requests.post(f"{BASE}/api/v1/extract/screenshot", headers=HEADERS,
    json={"url": "https://www.nike.com", "mode": "ultra"}).json()
print(hard["credits_used"], "credits used")

curl:

curl -s https://api.scavio.dev/api/v1/extract/screenshot \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","mode":"normal"}'

Response shape

Every response uses the envelope { data, response_time, credits_used, credits_remaining }.

{
  "data": {
    "url": "https://example.com/",
    "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA7E...",
    "image_format": "png",
    "mode": "normal",
    "image_bytes": 16917
  },
  "response_time": 4255,
  "credits_used": 1,
  "credits_remaining": 4574
}

Guardrails

• Cost tracks the tier: normal and advanced are 1 credit, ultra is 5. Only a successful capture is billed.
• The capture is always the full page. If the user only wants the fold, crop the returned PNG yourself.
• Never fabricate the image, its size or its contents. Only report what the API returned.
• The image URI can be large. Decode it to a file rather than pasting the base64 into a prompt.

Failure handling

• 400 means an invalid or missing url, or an unreachable internal/loopback host. Fix and retry.
• 401 means the API key is invalid or missing. Check SCAVIO_API_KEY.
• 404 means the target page was not found.
• 422 means the page cannot be captured - try a higher mode, or accept that the site blocks capture.
• 429 means rate or usage limit exceeded. Wait before retrying. See rate limits.
• 502 / 503 mean the source is temporarily unavailable - wait a few seconds and retry.
• If SCAVIO_API_KEY is not set, prompt the user to export it before continuing.