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.

Create an account and confirm your email: your key comes with 100 free API captures a month, no card needed. A paid plan adds volume, geotargeting, storage and schedules. Create an account

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.

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.

# 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,
)

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.