Extract

Screenshot API

Capture a full-page screenshot of any public URL and get it back as a PNG, returned inline as a base64 data URI you can drop straight into an <img> tag. Tier-priced by mode: normal and advanced cost 1 credit, ultra costs 5. Only a successful capture is billed - a page that can't be captured costs nothing.

POST/api/v1/extract/screenshot

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

urlstringrequired

The page to capture, 1-2048 characters. http and https only; a bare host like example.com is upgraded to https. Loopback, private, link-local and cloud-metadata hosts are rejected with a 400 before anything runs, so they cost nothing. Always captured as a full-page image, not just the viewport.

Example: https://example.com

modeenum<string>default:normal

Capture tier, and the price-bearing parameter - this is what makes the call cost 1 credit or 5. Start at normal and step up only when a site refuses it.

normal — Fast capture that covers most sites. 1 credit. The default.
advanced — Waits longer for JavaScript-built and late-painting pages to finish rendering before the shot. Still 1 credit.
ultra — Reaches the hardest anti-bot sites. 5 credits.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# screenshot is a TOP-LEVEL method, not a namespace.
shot = client.screenshot("https://example.com")
print(shot["data"]["image"])  # data:image/png;base64,...

Response

"url": "https://example.com/",

"image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA7EAAAL9CAIAAA...[truncated]",

"image_format": "png",

"mode": "normal",

"image_bytes": 16917

"response_time": 4255,

"credits_used": 1,

"credits_remaining": 4574

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # screenshot is a TOP-LEVEL method, not a namespace. shot = client.screenshot("https://example.com") print(shot["data"]["image"]) # data:image/png;base64,...