close page icon

Screenshot API

default parameters description
r type of the request, in this case: screenshot
apikey your private unique api key
function parameters description
domain Required if no fullurl is set. Full domain name, including the tld e.g. whoapi.com
fullurl Required if no domain is set. Complete URL; if set the domain parameter is ignored; takes a screenshot of exact website page
process Required. Processing type, that could be:
thumb - make a first viewport screenshot (for a specified screen resolution) and a thumbnail;
fullpage - make a screenshot of a fullpage (with all the scrolling), no thumbnail;
thumbfullpage - make a screenshot of a fullpage (with all the scrolling) with a thumbnail.
resolution Optional. Specify exact screen resolution in pixels (browser viewport). Supported options are: 1366x768, 1920x1080, 1280x1024, 1280x800, 1024x768. Default, if not specified: 1366x768
delay Optional. Delay in milliseconds between the full page load and a screenshot, e.g. 1000 (which is 1 second). Maximum delay allowed: 5000 (which is 5 seconds). Default: 0 (no delay). Please, be advised: that the more delay you set the longer it will take to process a screenshot; if you are using process=fullpage or process=thumbfullpage the delay is made after each full viewport scroll, that can delay the processing on pages with a long scroll.
thumbwidth Optional. The width of a thumbnail in pixels, e.g. 133. Default, if not specified: 133
thumbheight Optional. The height of a thumbnail in pixels, e.g. 100. Default, if not specified: 100
asap Optional. As a default, our screenshot API waits for all resources (images, JavaScripts, styles) to load completely. That takes time. If you do not want to wait for all page resources to load you can send "asap=true" parameter in your request. In this case we will wait only for the HTML to load. You can use this parameter with the "delay" option to manually control the time before the screenshot will be made.
node_geo Optional. Specify the country from which the request will be made. Random country will be used if this parameter is empty.
Screenshot API icon

Screenshot

This website screenshot API delivers domain website screenshot in actual full vertical size and a website thumbnail.

Sign up

Additional information:

All images are stored on our servers for no more than 24 hours. Please download images to your server in order to keep it. You can include the resulting image urls into your website, however be adviced that in case of a huge traffic load we reserve the right to block excesive requests. Keep in mind that depending on the request and page complexity it can take a long time to process a screenshot, use high enough timeouts to get a result.

By default our API waits for all page resources (images, JavaScripts, styles) to load completely. The overall timeout for the load is 30 seconds. If the resources could not be loaded within the set timeframe the API will return an error. If you need to change this behavior you can use the "asap=true" option described above.

See it in action:

You can test our screenshot API using the form below. Just enter an URL and see the resulting thumbnail.

 


Let's make an example request:

http://api.whoapi.com/?domain=whoapi.com&r=screenshot&apikey=demokey&process=thumb
Output in JSON format:
{
    "status": "0",
    "full_size": "http:\/\/node1.whoapi.com\/tmp\/e0dddcfa02522f28ea79c5126a24882d.jpg",
    "thumbnail": "http:\/\/node1.whoapi.com\/tmp\/e0dddcfa02522f28ea79c5126a24882d_th.jpg",
    "expires": "2018-01-17 19:37 GMT",
    "size": "1366x768",
    "requests_available": 100
}

http://api.whoapi.com/?domain=whoapi.com&r=screenshot&apikey=demokey&process=thumb&asxml
Output in XML format:
<?xml version="1.0"?>
<response>
  <status>0</status>
  <full_size>http://node1.whoapi.com/tmp/e0dddcfa02522f28ea79c5126a24882d.jpg</full_size>
  <thumbnail>http://node1.whoapi.com/tmp/e0dddcfa02522f28ea79c5126a24882d_th.jpg</thumbnail>
  <expires>2018-01-17 19:37 GMT</expires>
  <size>1366x768</size>
  <requests_available>100</requests_available>
</response>


Parameters explained:
status - processing result, "0" means success; in case of unsuccessful processing an additional parameter "status_desc" will be added with explanation of the error;
full_size - the full size image; for process=thumb it's size will be equal the specified resolution, if a full page processing is requested the height of the image can be higher than the set resolution;
thumbnail - the small image of the website with size set in the thumbwidth and thumbheight parameters (133x100 pixels by default);
expires - the date and time in GMT when the images will no longer be available (will be removed from our servers);
size - the full screenshot size in pixels, for example: 1920x1080 for a process=thumb and resolution=1920x1080;
requests_available - the requests left that you have in your package.

Screenshot API use case

Have you ever been in a situation where you needed more than one pair of eyes? Looking into millions of website can be time consuming, to say the least, so why not do it programmatically? Especially if you need a website screenshot or a thumbnail!

You can tell so much just by glancing at a small thumbnail! You can see if there’s a complete website, or just ads provided by domain registrar. You can see if the colors are bright or dark. You can see if there’s a menu, or just a logo.

Screenshot API Pricing

Request limit 6,000 / month 18,000 / month 54,000 / month 162,000 / month 486,000 / month
Full size website screenshot Check icon Check icon Check icon Check icon Check icon
Thumbnail website screenshot Check icon Check icon Check icon Check icon Check icon
Money back guarantee Check icon Check icon Check icon Check icon Check icon
Console Check icon Check icon Check icon Check icon Check icon
Delay and ASAP Check icon Check icon Check icon Check icon Check icon
GEO screenshots Check icon Check icon Check icon Check icon Check icon
Alternative resolutions Check icon Check icon Check icon Check icon Check icon
Support Forum Email, 48 hours Email, 48 hours Priority Priority
Additional 50,000 request Check icon Check icon $25 $20 $15
Screenshot API $9 / Month
$86 / Year
$23 / Month
$216 / Year
$56 / Month
$540 / Year
$141 / Month
$1350 / Year
$352 / Month
$3375 / Year
Order now Order now Order now Order now Order now

Don't see a package that suits your needs? Looking for something in between, or bigger than our biggest package? Contact our support.

Start using our API today!

To start using our API you need to create an account with a real email address.

By proceeding, you agree to the Terms of Use.
All your data is encrypted and secured.
Forgot your password?

Scroll to top