Complete API reference for the Site-Shot website screenshot API. Every parameter is documented with examples — integrate URL to image capture into your application in minutes.
https://api.site-shot.com/?url=https://example.com/&userkey=YOUR_API_KEY
Specify API key and a web-site URL to create screenshot, remember that all parameters needs to be url encoded.
&url=https://www.wikipedia.org/
Set webview width in pixels, default value: 1024px
Values range: 100 - 8000
&width=1280
Set webview height in pixels, default value: 768px
Values range: 100 - 20000
&height=1024
Set webview percentage zoom, default value: 100
Values range: 5 - 1000
&zoom=200
Capture entire document canvas, default value: 0
Document maximum height is limited by max_height parameter
&full_size=1
Set webview maximum height in pixels, default value: 15000px
The max-height parameter is only relevant if full_size is set to 1
Values range: 100 - 20000
&max_height=5000&height=1280&full_size=1
Specify a custom user agent string
The value have to be url encoded, provided example below contains user agent string for browser Chromium
&user_agent=Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Ubuntu
Chromium/64.0.3282.167 Chrome/64.0.3282.167 Safari/537.36
Scale result image to specified width
The value can not be smaller than height
Values range: 50 - 10000
&scaled_width=200
Image format, default value: PNG
Possible values: PNG, JPEG
&format=jpeg
API response content-type, default value: image
In case of JSON response, API provide image encoded in base64 and extra information: http response code, http response headers, error in case of unsuccessful response
Possible values: IMAGE, JSON
&response_type=image
Your personal unique identifier.
You can get it after signup process in Dashboard
Please keep the key in secret
&userkey=YOUR_API_KEY
Delay the screenshot capture, default value: 1500.
Have to be specified in milliseconds
Values range: 0 - 60000
&delay_time=2000
Limit the maximum time for screenshot creation, default value: 60000
If screenshot isn't created in time API return timeout error
Have to be specified in milliseconds
Values range: 0 - 120000
&timeout=60000
Specify a custom request headers fields
Allowed multiple request_header parameters
Provided examples below, specified Cookie and Referer http headers
&request_header=Cookie:SSID=WX84BVOEA3WEDSHJHG
&request_header=Referer:http://www.website.com/
Specify a http proxy server, default value: http://localhost:3128
&http_proxy=http://localhost:3128
Specify an username for proxy server
&proxy_username=james
Specify a password for proxy server
&proxy_password=changeme
Get the rendered source code of the web page, default value: 0
Applicable only together with response_type=json
&source_code=1
Ingest custom JavaScript code into the web page
&javascript_code=document.getElementById('uc-central-banner-modal').style="display:none"
High quality proxy would be automatically rotated, default value: 1
&proxy_rotation=1
Block cookie banners on websites, default value: 0
&no_cookie_popup=1
Block ads from popular ad-networks, default value: 0
&no_ads=1
Specifies the geographic country for the screenshot request
Automatically sets a proxy IP from the selected country
Also automatically sets default language, time zone and geolocation coordinates for that country if they are not manually overridden
A list of available countries and their default settings can be found the countries reference page.
&country=Br
Simulates precise physical browser location using latitude and longitude coordinates
Has no effect on IP-based geolocation (use country for that)
Can be combined with country to simulate both network and GPS presence
Format: A comma-separated string of latitude and longitude
&geolocation=48.8566,2.3522
(Simulates the browser being located in Paris, France)
Sets the default browser language (e.g., for the Accept-Language header)
If country is provided and language is not, the language is taken from the country setting
If language is explicitly provided, it overwrites any default set by country
&language=ja
Sets the time zone to be used by the browser
If country is provided and time_zone is not, the time zone is taken from the country setting
If time_zone is explicitly provided, it overwrites any default set by country
Default Value: America/New_York (if no country is specified)
A list of available time zones can be found the time zones reference page.
&time_zone=Europe/London
Below is a combined example demonstrating the country, geolocation, language, and time_zone parameters together:
https://api.site-shot.com/?url=https%3A%2F%2Fwww.wikipedia.org%2F&userkey=YOUR_API_KEY&country=Brazil&geolocation=35.6895,139.6917&language=ja&time_zone=Asia/Tokyo&width=1280&height=1024
Explanation:
country=Brazil - Sets a Brazilian proxy IP and defaults (unless overridden).
geolocation=35.6895,139.6917 - Simulates the browser being physically located in Tokyo, Japan.
language=ja - Overrides the default Portuguese with Japanese.
time_zone=Asia/Tokyo - Overrides the default Brazilian time zone.
Just copy code for your language and add API key.
Our website screenshot API is built for reliability. Highly available infrastructure ensures your automated screenshot workflows never miss a capture.
Take a website screenshot instantly — no registration required. Enter any URL and capture a full page image for free, right in your browser.
Generate thousands of automated website screenshots per hour. Our infrastructure scales horizontally to match your volume — from thumbnails to bulk captures.
Capture any website screenshot in seconds. Our API renders pages with a real Chromium browser for pixel-perfect, production-quality results.
A website screenshot API is a web service that captures a visual image of any web page from its URL. You send an HTTP GET request with the target URL and receive back a PNG or JPEG screenshot. Site-Shot's API supports full page capture, custom viewport sizes, device emulation, proxy rotation, and geolocation — all through simple query parameters.
Send a GET request to https://api.site-shot.com/ with the url and userkey parameters. For example: https://api.site-shot.com/?url=https://example.com&userkey=YOUR_API_KEY. The API returns a screenshot image directly, or as base64-encoded JSON. Code samples are available for Python, Node.js, PHP, Java, C#, Go, Ruby, cURL, and Perl.
Yes. Set the full_size=1 parameter to capture the entire scrollable page, not just the visible viewport. You can control the maximum height with the max_height parameter (up to 20,000 pixels). This is useful for capturing long landing pages, articles, and single-page applications.
No. You can use the free online screenshot tool on our homepage without registering. Just enter a URL and click Shot. To use the API for automated screenshots, sign up for a plan and get your personal API key from the Dashboard.
Yes. The country parameter routes your request through a proxy IP in the selected country. You can also use the geolocation parameter to simulate precise GPS coordinates, and the language and time_zone parameters for full localization. This lets you see exactly how a website appears to visitors in any location worldwide.
Site-Shot provides ready-to-use code samples for Python, Node.js, PHP, Java, C#, Go, Ruby, cURL, and Perl. Since the API is a simple REST endpoint, it works with any language or tool that can make HTTP GET requests.
The API supports PNG and JPEG output. PNG is the default and provides lossless quality. JPEG is useful when you need smaller file sizes for thumbnails or previews. Set the format parameter to choose your preferred output.
Use the no_ads=1 parameter to block ads from popular ad networks, and no_cookie_popup=1 to remove cookie consent banners. Both can be combined for clean, distraction-free website captures.