Developer API

SiteThumbshot service is simply an HTTP GET or POST request. The service parameters are passed as simple HTTP parameters.

All requested URLs start with the host-name (customized URLs available for premium users) and resemble the following code:

http://images.sitethumbshot.com/

How to request a thumbnail:

You can request screenshots with your key using this simple API - but please always bear in mind our Terms and Conditions:

Append to the standard request url above the method followed by a question mark.

http://images.sitethumbshot.com/?

The method is followed by the actual query parameters, which take the form argument=value, where the arguments and values are url encoded. Multiple parameters are separated by an ampersand (&).

http://images.sitethumbshot.com/?size=[size]&key=[key]&url=[url]&format=[format]&quality=[quality]

Parameter	Type	Description
key	String (required)	All requests to SiteThumbshot service require a key. Sign-up and get your own key.
url	String (required)	The url to get the thumbnail for. The url must start with http:// or https://. Try to encode url parameter (in PHP you can use urlencode function for this purpose) otherwise in some cases you might get "Forbidden 403" error.
size	String (Optional), default is T if not provided	The size of thumbnail. Available sizes are: T (80 x 60), S (120 x 90), M (200 x 150), XM (400 x 300), L (640 x 480), ML (800 x 600) and XL (1024 x 768). If the parameter value is not set, the T size will be returned. Check your plan to see what sizes you can access in your plan.
format	String (Optional)	JPG/GIF/PNG. Default is JPG for all packages, only JPG is format is available for Free users.
quality	String (Optional)	Quality of generated thumbnails. Check your plan for available value(s) of this parameter.

The following example retrieves a large thumbnail for http://www.google.com:

http://images.sitethumbshot.com/?url=http://www.google.com&size=L&key=1234567890&format=jpg&quality=80

Check if a thumbnail exists:

Premium users can check existance of thumbnail before actually requesting a thumbshot.

Append to the standard request url followed by exist/ and a question mark.

http://images.sitethumbshot.com/exist/?

The method is followed by the actual query parameters, which take the form argument=value, where the arguments and values are url encoded. Multiple parameters are separated by an ampersand (&).

http://images.sitethumbshot.com/exist/?key=[key]&url=[url]

Parameter	Type	Description
key	String (required)	All requests to SiteThumbshot service require a key. Sign-up and get your own key.
url	String (required)	The url to get the thumbnail for. The url must start with http:// or https://. Try to encode url parameter (in PHP you can use urlencode function for this purpose) otherwise in some cases you might get "Forbidden 403" error.

 

For each request, the server will return a JSON response indicating whether the request was successful or not.

Returned values:

Response Body	Description
{"result": "Invalid URL"}	URL provided in the request is not validated by our system.
{"result": "Key is missing"}	Key is not provided, all requests to SiteThumbshot service require a key. Signup and get your own key.
{"result": "Invalid Key"}	Key provided is not valid. This key is sent via email once you complete your registration. You can also get this key after login to our website.
{"result": "Not Allowed "}	Your package does not allow you to acess this API, please upgrade your account.
{"result": "Yes"}	Thumbnail exists for the requested URL.
{"result": "No"}	Thumbnail is not yet captured by our system.

 

Get Thumbnail POPUP code for your website.