Get a Free Trial

Take Website Screenshots with Java

DownloadTechnical Information
Java API
The diagnostics panel can help you debug your code!

There are several ways that the GrabzIt API can be used to take screenshots and more in Java. To get started with the API follow these steps:

  1. Get your free Application Key and Secret.
  2. Download the free Java Library and try out the Demo Application.
  3. Find out the basics about how GrabzIt's API works by reading the below overview.

Java API Overview

The first stage on starting to use the API in your Java App is to create an instance of the GrabzItClient class, passing your application key and application secret from your GrabzIt account to the constructor.

//Create the GrabzItClient class
//Replace "APPLICATION KEY", "APPLICATION SECRET" with the values from your account!
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

Then use one of the image, PDF, DOCX, animation or table options to capture a URL or convert HTML.

// To take a image screenshot
grabzIt.URLToImage("https://www.tesla.com"); 	
// Or to take a PDF screenshot
grabzIt.URLToPDF("https://www.tesla.com");
// Or to convert online videos into animated GIF's
grabzIt.URLToAnimation("http://www.example.com/video.avi");
// Or to capture table(s)
grabzIt.URLToTable("https://www.tesla.com");
// To convert HTML into a image
grabzIt.HTMLToImage("<html><body><h1>Hello World!</h1></body></html>"); 	
// Or convert HTML into a PDF document
grabzIt.HTMLToPDF("<html><body><h1>Hello World!</h1></body></html>");
// Or convert HTML into a CSV, XLSX or JSON document
grabzIt.HTMLToTable("<html><body><table><tr><th>Name</th><th>Age</th></tr>
    <tr><td>Tom</td><td>23</td></tr><tr><td>Nicola</td><td>26</td></tr>
    </table></body></html>");
// To convert HTML file into a image
grabzIt.FileToImage("example.html"); 	
// Or convert HTML file into a PDF document
grabzIt.FileToPDF("example.html");
// Or convert HTML file into a CSV, XLSX or JSON document
grabzIt.FileToTable("tables.html");

Next the result must be saved by using use one of the following two save methods. With the Save method the URL of a handler needs to be specified, which will process the callback from GrabzIt and save the resulting screenshot. As this method requires a callback handler it is usually only possible to use this approach in a web application.

grabzIt.Save("http://www.example.com/handler"); 	
Always use the SaveTo method on localhost

Alternatively use the synchonous SaveTo method, which will force your application to wait while the screenshot is created so it should only be used were the Save method cannot be used, such as in a desktop application.

Once the screenshot is created it is saved to the file path provided.

String filepath = "images/result.jpg";
grabzIt.SaveTo(filepath);

More Options

All of our online services such as creating web captures, animated GIF's or converting HTML have many customizable options including; configuring the browser height, browser width, screenshot height, screenshot width, the delay before a screenshot is taken and the image format of the screenshot. For all these options and more information on creating PDF's, animated GIF's and CSV's from web content please see the Client documentation. There are also more advanced examples available.