Quick Start
The screenshot API is a REST endpoint that accepts GET requests. The minimum required parameters are:
url— the web page to capture (URL-encoded)userkey— your personal API key: create an account on the API quickstart; a confirmed account's key comes with the free plan, 100 captures a month, no card needed
The API returns the screenshot image directly by default. Set response_type=json to receive base64-encoded image data along with HTTP response metadata.
Calling it from a browser: a successful capture carries Access-Control-Allow-Origin: *, so a web page can fetch it directly with userkey in the query string. A request refused at the key check (a missing or wrong key, HTTP 401) carries no CORS header, so the page's script sees a network error rather than the 401. A key in front-end code is visible to every visitor, who can spend your captures; on a public page, call the API from your server.
Key API Features
Rendering
- Full page capture (
full_size=1) - Custom viewport width, height, and zoom
- Desktop and mobile device emulation
- Custom user agent strings
- JavaScript injection
- Configurable delay and timeout
Network & Output
- Proxy rotation with country-specific IPs (free plan: the default location or the US; other countries on paid plans)
- GPS geolocation simulation
- Custom HTTP headers (cookies, referer)
- PNG, JPEG and lossless WebP (about 35% smaller than PNG) output formats
- Scaled output (thumbnails)
- JSON response with base64 + metadata
Code Samples
Ready-to-use code is available for 9 programming languages. Here's a quick Python example:
import requests
response = requests.get("https://api.site-shot.com/", params={
"url": "https://example.com",
"userkey": "YOUR_API_KEY",
"width": 1280,
"height": 1024,
"format": "png",
}, timeout=70)
# Only a 200 is a screenshot: a failed capture is HTTP 404 with an error
# image, a wrong key is 401.
if response.status_code != 200:
raise SystemExit(f"capture failed: HTTP {response.status_code}")
with open("screenshot.png", "wb") as f:
f.write(response.content)
View all code samples (Python, Node.js, PHP, Java, C#, Go, Ruby, cURL, Perl) →
Pricing
The online tool above is free with no registration. A confirmed account's API key comes with the free plan: 100 API captures a month, no card needed. Free-plan captures come from the default location or the US; geotargeting, storage and schedules need a paid plan. Each paid plan includes a set number of prepaid screenshots per month, dedicated rendering workers, and a per-screenshot rate for overages.
Common Integrations
- Website monitoring — schedule periodic captures to detect visual changes or downtime.
- Link previews — generate thumbnail images for URLs shared in chat apps, CMS platforms, or social tools.
- SEO tools — capture SERP pages or competitor sites for visual tracking and reporting.
- Testing and QA — automate visual regression testing across viewport sizes.
- PDF generation — capture styled web content as images for inclusion in reports and documents.
Let's Get In Touch
Questions about screenshots, API access, or integrations? Reach the team directly.