Getting Started

Render a Screenshot (GET)

GET https://shot.screenshotapi.net/screenshot?token=TOKEN&url=URL&[OPTIONS]

The following options for the API call are:

TOKEN: The TOKEN or your API key should be replaced by your real ScreenshotAPI API, you can find your API key after you Sign Up or Log In to the service via the Dashboard page.

Note: If for any reason you need to get a new API key, simply click "Roll API Key" in the "Settings" card on the Dashboard. This will issue you a fresh API key and revoke access from the previous key.

URL: Website URL for the site you would like to render for the screenshot. We support a wide variety of websites types, such as single page apps, very long-content, and sites that require lazy loading or delays ensuring accurate and complete screenshots of these unique sites.

OPTIONS: Options indicates the different URL parameters keys and values that can be used to render your "perfect" screenshot. All the options for screenshots will be detailed below.

Note: Default options for the screenshot will be shown in the Options table below.

Example:

GET https://shot.screenshotapi.net/screenshot?token=TOKEN&url=https://apple.com

This will render the following png image output when you paste in the above string into your browsers URL bar (replacing TOKEN with your API key):

Cached & Fresh screenshot

When you take a screenshot, it automatically get cached on our backend, so when you make a get request to the same URL this will return the same screenshot that got cached, but if you want to take a newer screenshot of the URL provided, you may want to use our fresh screenshot functionality.

Example:

Get https://shot.screenshotapi.net/screenshot?token=TOKEN&url=https%3A%2F%2Fwww.apple.com%2F&fresh=true&[OPTIONS]

In the following video, you will see an example of how the 'Fresh Screenshot' functionality is used. First, we demonstrate how a regular request to a specific URL is made for the first time, which typically takes a few seconds since it's the initial request. Then, the same request is made a second time, which is much faster because it retrieves the cached screenshot. However, if you want to capture a completely new screenshot without using the cached one, you should click the checkbox labeled 'Fresh screenshot' as shown in the example during the third request in the video.

Remove elements from a page

You can select elements by class name, ID, or other CSS selectors and then add the display: none attribute to hide them on the inject CSS feature.

Example:

Get https://shot.screenshotapi.net/screenshot?token=TOKEN&url=https%3A%2F%2Fwww.apple.com%2F&output=image&file_type=png&wait_for_event=load&css=.module-content%7Bdisplay%3A%20none%7D%0A

In the following video, you'll find a more illustrative example of how to use the 'Inject CSS' functionality to remove an element from a page. In the first request, you'll see a standard screenshot to observe the page's initial state. Then, in the second request, we demonstrate how to achieve this by utilizing the 'Inject CSS' feature to remove the desired element.

Scrolling screenshots

You can access the 'Scrolling Screenshot' functionality, which allows you to capture a video (in webm, gif, or mp4 format) of a web page with various customizable options. These options include the ability to scroll backward, adjust scrolling speed, set the duration, and start recording instantly

Example:

Get https://shot.screenshotapi.net/screenshot?token=TOKEN&url=https%3A%2F%2Fgoogle.com&output=json&file_type=gif&wait_for_event=load&scrolling_screenshot=true

In the following video, you'll find a more illustrative example of how to utilize the 'Scrolling Screenshot' functionality. When you click the 'Take Screenshot' button, it will take a few seconds to capture the video and provide you with JSON containing the video information.

Here is the recorded video demonstrating the example.

Multiple Scrolling screenshots

In addition to the 'Scrolling Screenshot' functionality, our application offers the feature of 'Multiple Scrolling Screenshots'. With this feature, you can capture multiple scrolling screenshots of web pages, each with different sizes in terms of width and height. This means you have the flexibility to customize the dimensions of the screenshots according to your specific requirements.

Example:

In the parameters of the endpoint, we will pass an array of objects with different sizes. To achieve this, we need some code to pass this array in the 'sizes' parameter.

let sizesArr = [
	{ id: 1, width: 1920, height: 1080 },
	{ id: 2, width: 1280, height: 720 },
	{ id: 3, width: 800, height: 450 }
];
let SIZES = JSON.stringify(sizesArr);

Get https://shot.screenshotapi.net/screenshot?token=TOKEN&url=https%3A%2F%2Fwww.apple.com%2F&output=json&file_type=gif&wait_for_event=load&scrolling_screenshot=true&multiple_scrolling=true&sizes=SIZES

In the following video, you'll find a more illustrative example of how to utilize the 'Multiple Scrolling Screenshot' functionality. When you click the 'Take Screenshot' button, it will take a few seconds to capture the video and provide you with JSON containing the video information.

Request Options

GET https://shot.screenshotapi.net/screenshot?token=TOKEN&url=https://apple.com

Path Parameters

{ 	// Response}

Request Options

GET https://shot.screenshotapi.net/screenshot?token=TOKEN&url=https://apple.com&scrolling_screenshot=true

Path Parameters

Errors

Query Builder

Use our Query Builder to explore our API. (If you are logged in your API key is automatically added). To easily view all the screenshot options in an interactive builder to ensure you have your ideal screenshot dialed in.

You can check out the Query Builder here: ScreenshotAPI.net .

Inject JavaScript

Inject Javascript field is a javascript code that the browser can execute before taking the screenshot.

For example: Try taking a screenshot of ScreenshotAPI.net and paste this code in the "Inject JS code" input of the query builder:

document.getElementsByClassName('display-heading')[0].innerHTML = 'This is a test to help the customer'

Page Range

We added a new option recently specifically for the PDF output. You can select the range that you want to select. Sometimes if the screenshot has unnecessary details that bleed into another page and you want to remove that from the screenshot, you can customize the page range that gets outputted directly from the Query Builder.

pdf_options%5Bpage_range%5D)=1-1

Extract HTML or Text

This option on the query builder allows you to store the HTML and the text of the site. You currently need to set the output as json to grab the URLs. If you are using the img output, for example, we will extract the information but there is no way to grab the URLs.

Code Examples

Below is sample code for the following languages: Node.JS, PHP, Go, Java, Python, and Ruby.

If you need assistance integrating into our API with a given language please contact us.

var fs = require("fs");var request = require("request");

// @param {String} token - String containing your API Key// @param {String} url - Encoded URI string container the URI you're targeting// @param {String} output - String specifying the output format, 'image' or 'json'// @param {String} file_type - String specifying the output typevar token = "Your API Key";var url = encodeURIComponent("https://google.com");var output = "image";var file_type = "png";

// Construct the query params and URLvar query = "https://shot.screenshotapi.net/screenshot";query += `?token=${token}&url=${url}&output=${output}&file_type=${file_type}`;

// Call the API and save the screenshotrequest.get({ url: query, encoding: "binary" }, (err, response, body) => { 	fs.writeFile("screenshot.png", body, "binary", (err) => {		 if (err) {			 console.log(err); 		 } else {			 console.log("The file was saved!"); 		 }  	}); });```

// @param {String} $token - String containing your API Key // @param {String} $url - Encoded URI string container the URI you're targeting // @param {String} output - String specifying the output format, "image" or "json"// @param {String} file_type - String specifying the output type$token = 'Your API Key';$url = urlencode('https://google.com');$output = 'image';$file_type = 'png';

// Construct the query params and URL$query = "https://shot.screenshotapi.net/screenshot";$query .= "?token=$token&url=$url&output=$output&file_type=$file_type";

// Call the API$image = file_get_contents($query);

// Save the screenshotfile_put_contents('./screenshot.png', $image);

package main
import ( 	"fmt" 	"io" 	"io/ioutil" 	"net/http"	 url2 "net/url" 	"os")
func main() { 	// @param {String} token - String containing your API Key  	// @param {String} url - Encoded URI string container the URI you're targeting 	// @param {String} output - String specifying the output format, 'image' or 'json' 	// @param {String} file_type - String specifying the output type   	 token := "Your API Key"	 url := url2.QueryEscape("https://google.com")	 output := "image"	 file_type := "png"
 	// Construct the query params and URL	 query := "https://shot.screenshotapi.net/screenshot"	 query += fmt.Sprintf("?token=%s&url=%s&output=%s&file_type=%s",		 token, url, output, file_type)
 	// Call the API	 resp, err := http.Get(query)	 if err != nil{ 		 panic(err) 	} 	 defer resp.Body.Close()
 	// Raise error if call was unsucessfull 	if resp.StatusCode != 200 {		 errorBody, _ := ioutil.ReadAll(resp.Body)		 panic(fmt.Errorf("error while calling api %s", errorBody)) 	} 
 	// Save the screenshot	 file, err := os.Create("./screenshot.png")	 if err != nil {		 panic(err) 	} 	 defer file.Close()
	 _, err = io.Copy(file, resp.Body) 	if err != nil {		 panic(err) 	} }

package main;
import java.io.FileOutputStream;import java.io.InputStream;import java.io.OutputStream;import java.net.URL;import java.net.URLEncoder;
public class Main{
	public static void main(String[] args) {		try {			// @param {String} $token - String containing your API Key 			// @param {String} $url - Encoded URI string container the URI you're targeting 			// @param {String} $output - String specifying the output format, 'image' or 'json'			// @param {String} file_type - String specifying the output type			String token = "Your API Key";			String url = URLEncoder.encode("https://google.com");			String output = "image";			String file_type = "png";
			// Construct the query params and URL			String query = "https://shot.screenshotapi.net/screenshot"; 			query += String.format("?token=%s&url=%s&output=%s&file_type=%s",				token, url, output, file_type);			URL apiUrl = new URL(query);
			// Call the API and save the screenshot			InputStream inputStream = apiUrl.openStream();			OutputStream outputStream = new FileOutputStream("./screenshot.png");			inputStream.transferTo(outputStream);
			inputStream.close();			outputStream.close(); 		} catch(Exception ex) {			ex.printStackTrace(); 		} 	} }

import urllib.parseimport urllib.requestimport ssl
ssl._create_default_https_context = ssl._create_unverified_context
# @param {String} $token - String containing your API Key# @param {String} $url - Encoded URI string container the URI you're targeting # @param {String} $output - String specifying the output format, 'image' or 'json'# @param {String} file_type - String specifying the output typetoken = "Your API Key"url = urllib.parse.quote_plus("https://google.com")output = "image"file_type = "png"
# Construct the query params and URLquery = "https://shot.screenshotapi.net/screenshot"query += "?token=%s&url=%s&output=%s&file_type=%s" % (token, url, output, file_type)
# Call the APIurllib.request.urlretrieve(query, "./screenshot.png")

require "net/http"require "uri"
# Define your API Key, URL, output type, and file typetoken = "Your API key"url = URI.encode("https://google.com")output = "image"file_type = "png"
# Construct the query URLquery = "https://shot.screenshotapi.net/screenshot"query += "?token=#{token}&url=#{url}&output=#{output}&file_type=#{file_type}"
# Send a GET request to the APIuri = URI.parse(query)response = Net::HTTP.get_response(uri)
# Check if the response was successfulif response.code == "200"	# Save the screenshot as a binary file	File.open("screenshot.png", "wb") do |file|		file.write(response.body)	end	puts "The file was saved!"else	puts "Error: #{response.code} - #{response.message}"end

const requestOptions = { method : "GET", redirect : "follow"}; 
fetch (	'https://shot.screenshotapi.net/screenshot?token=${token}&url=${url}&output=${output}&file_type=${file_type}";	requestOptions).then((response) => response.text()).then((result) => console.log(result)).catch((error) => console.error(error));

/**	* Takes a website URL as input and returns a screenshot of the website using the ScreenshotAPI service.	* @param {string} websiteUrl - The URL of the website to take a screenshot of.	* @return {string} screenshotUrl - The URL of the screenshot image.	* @customfunction	*/async function SCREENSHOT(websiteUrl) {	const YOUR_API_KEY = "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX"; // Your ScreenshotAPI API key	const query = `https://shot.screenshotapi.net/screenshot?token=$ {YOUR_API_KEY}&url=${websiteUrl} &output=image&file_type=png`; // Construct the query params and URL	const options = {	"method" : "get",	"contentType": "application/json",	"followRedirects":false	}; // The options for the fetch request	const response = await UrlFetchApp.fetch(query,options); // Make the fetch request to ScreenshotAPI	const screenshotUrl = response.getHeaders()["Location"]; // Get the URL of the screenshot from the response headers	return screenshotUrl; // Return the URL of the screenshot}

Proxy

We have a free proxy you can use if you need one: http://xo:llksoigsgrewvc@137.184.64.168:3128

Support

At ScreenshotAPI we are there for you. We are developers ourselves and strive to ensure you have a great screenshot experience.

If the ScreenshotAPI.net API is unavailable to all for more than three consecutive hours in any one calendar day, beginning at 12:00:01 AM PST and ending at 11:59:59 PM PST time of the same day, an outage will be deemed to have occurred. If there are more than three outages within any one calendar week, beginning at 12:00:01 AM PST on a Monday and ending at 11:59:59 PM PST on a Sunday, then You may terminate this Agreement, without liability, by providing written notice to ScreenshotAPI.net of Your intention to do so within one calendar week of the third outage. Upon such termination being accepted by ScreenshotAPI.net, You shall be entitled to a refund equal to the amount You have paid for the latest term.

If you need help at any point please contact us at info@screenshotapi.net or go to Help Desk