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

The API needs a key. Create an account, confirm your email address, and the key is waiting on your dashboard. Create an account

Already have an account? Sign in — your key is on the 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 '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

That writes screenshot.png next to your script.

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