GET

/v1

api_key*
url*
capture_full_page
width
height
delay
css_injection
user_agent
export_format
curl --request GET \
  --url https://screenshot.abstractapi.com/v1

It’s very simple to use: you only need to submit your api_key and a single URL, and the API will respond as an screenshot of the provided website.

​
Getting started

​
REST

The Website Screenshot API, like all of Abstract’s APIs, is organized around REST. It is designed to use predictable, resource-oriented URL’s and to use HTTP status codes to indicate errors.

​
HTTPS

The Website Screenshot API requires all communications to be secured TLS 1.2 or greater.

​
API Versions

All of Abstract’s API are versioned. The Website Screenshot API is currently on Version 1.

​
Your API Key

Your API key is your unique authentication key to be used to access Abstract’s Website Screenshot API. Note that each of Abstract’s API has a unique API key, so you will need different keys to access the Website Screenshot and Email Validation APIs, for example. To authenticate your requests, you will need to append your API key to the base URL.

​
Base URL

https://screenshot.abstractapi.com/v1/

​
Validation endpoint

Abstract’s Website Screenshot API only has two required parameters for the request, your unique API key and a single URL:

https://screenshot.abstractapi.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& url = https://news.ycombinator.com

This was a successful request, so the screenshot from that URL is returned below:

YCombinator news page screenshot

​
Request parameters

api_keyrequired
String

Your unique API key. Note that each user has unique API keys for each of Abstract’s APIs, so your Website Screenshot API key will not work for your User Avatar API, for example.

urlrequired
String

The URL to get the screenshot of. Note that this parameter should include the full HTTP Protocol (http:// or https://).

capture_full_page
Boolean

If true the request will capture the entire height and width of the page. Defaults to true.

width
Integer

The width in pixels of the view port to use to capture the image.

height
Integer

The height in pixels of the view port to use to capture the image.

delay
Integer

The time in seconds to wait between loading the page and taking the screenshot.

css_injection
String

A CSS string to inject into the website before capturing the image.

user_agent
String

The User Agent to use when capturing the screenshot.

export_format
String

The image format to use for the screenshot. Can be jpeg or png, and defaults to jpeg.