wget - Linux, Mac OS X, BSD

Use of the API requires authentication with your API key. Your key is displayed in the right column in your dashboard. If you do not yet have an account, please register for a free account.

To request a screenshot of the website http://mobilito.net/ with the default option, and save the image to /tmp/mobilito.png:

$ wget "https://api.browshot.com/api/v1/simple?url=http://mobilito.net/&key=my_api_key" -O /tmp/mobilito.png
[...]
HTTP request sent, awaiting response... 302
[following]
[...]
HTTP request sent, awaiting response... 200
Length: 115812 (113K) [image/png]
Saving to: `/tmp/mobilito.png`

$ file /tmp/mobilito.png
/tmp/mobilito.png: PNG image data, 1024 x 768, 8-bit/color RGB, non-interlaced

You can use any of the options listed on the API page to get thumbnails of different sizes, to use different browsers, etc. Here are some common use cases:

Thumbnail

To have a thumbnail with a width of 640 pixels, add the parameter width=640:

$ wget "https://api.browshot.com/api/v1/simple?url=http://mobilito.net/&key=my_api_key&width=640" -O /tmp/mobilito.png

To specify both width and height:

$ wget "https://api.browshot.com/api/v1/simple?url=http://mobilito.net/&key=my_api_key&width=640&height=480" -O /tmp/mobilito.png

Full page

By default, the screenshot of the screen is taken. To take a screenshot of the full page, add size=page:

$ wget "https://api.browshot.com/api/v1/simple?url=http://mobilito.net/&key=my_api_key&width=640&size=page" -O /tmp/mobilito.png

Choose a virtual browser

Browshot offers a large choice of Mobile browsers (iPhone, iPad, Android, etc.) and Desktop resolutions. You can pick the browser from your dashboard or from the API.

For example, to create a screenshot from a virtual iPhone4 held vertically (instance #22):

$ wget "https://api.browshot.com/api/v1/simple?url=http://mobilito.net/&key=my_api_key&instance_id=22" -O /tmp/mobilito.png

Or specify the screen resolution, for example screen=1024x768:

$ wget "https://api.browshot.com/api/v1/simple?url=http://mobilito.net/&key=my_api_key&screen=1024x768" -O /tmp/mobilito.png

All the options can be combined. You can get the full list on the API page.