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

API access requires a paid plan. Create an account, confirm your email, choose a plan, then take your first API screenshot. Create an account

Plans start at 5 USD/month for 2000 screenshots. There are no free API credits. Just need one image? The browser screenshot tool is free and needs no 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 --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.

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