Quickstart
Your first screenshot, in three steps
Site-Shot renders in a real Chromium browser — full-page capture, country proxies, ads and cookie banners removed. Node.js and Python have an official SDK; every other language calls the HTTP API directly.
1. Get your API key
Free-plan captures come from the default location or the US (country=US). One capture at a time: a second parallel request on a free-plan key gets HTTP 429. Every capture the API admits counts against the month, failed ones included.
Paid plans start at $5/month for 2,000 captures. Just need one image? The browser screenshot tool is free and needs no account.
Already have an account? Sign in to see your key here, filled into the code below, or on your dashboard. See plans.
2. Install
pip install site-shot
npm install site-shot-sdk
Both are zero-dependency and open source. Using another language? Skip to the cURL tab below — it is the same HTTP endpoint.
3. Capture
# pip install site-shot (Python 3.9+, zero dependencies)
from site_shot import SiteShot
client = SiteShot('YOUR_API_KEY') # or set SITESHOT_API_KEY in the environment
client.capture_to_file(
'https://example.com/',
'screenshot.png',
full_size=True,
no_ads=True,
no_cookie_popup=True,
)
// npm install site-shot-sdk (Node.js 18+, zero dependencies)
import { SiteShot } from 'site-shot-sdk';
import fs from 'node:fs/promises';
const client = new SiteShot('YOUR_API_KEY'); // or set SITESHOT_API_KEY in the environment
const png = await client.capture({
url: 'https://example.com/',
full_size: true,
no_ads: true,
no_cookie_popup: true,
});
await fs.writeFile('screenshot.png', png); // png is a Buffer
curl -G --fail 'https://api.site-shot.com/' \
--data-urlencode 'url=https://example.com/' \
--data-urlencode 'userkey=YOUR_API_KEY' \
--data-urlencode 'width=1280' \
--data-urlencode 'height=1024' \
--data-urlencode 'format=png' \
--data-urlencode 'response_type=image' \
--data-urlencode 'delay_time=2000' \
--data-urlencode 'timeout=60000' \
--output screenshot.png
If the request succeeds, that writes screenshot.png in the current folder. On an HTTP error the example stops and reports it instead of saving the error response as an image.
To run it, save the Node.js code as screenshot.mjs and run node screenshot.mjs (its import lines need an ES module: as a .js file in an npm init project it stops with "Cannot use import statement outside a module"). Save the Python code as screenshot.py and run python screenshot.py.
If a call fails: 401 means the key was not accepted; 403 means this month's captures are used up or the key has no active plan; 429 means the key's parallel-capture limit is reached (one capture at a time on the free plan); 404 means the page could not be captured. For 401, 403 and 429 the response body says why: run the cURL command without --fail and --output to print it.
Where to go next
- Every capture parameter — viewport, format, delay, country, full-page height cap.
- Capture from another country — the country proxy pool and its language defaults.
- Building an AI agent? — the MCP server runs with npx -y site-shot-mcp.
- Plans and limits