Skip to the content
Docs Back to the site Dashboard

Screenshots

Devices and sizes

A page does not look the same on a laptop and on a phone. Choose a device, or set the screen yourself.

Pick a device

device sets the screen size, the pixel density and, for a phone or a tablet, a mobile browser. One word instead of three numbers.

Portrait or landscape

A phone or a tablet is held upright unless you say otherwise. orientation=landscape turns it on its side: the screen gets wider than tall, and the page lays itself out for that.

orientation needs a phone or tablet device. Without one, orientation=landscape is refused with invalid_request: for a wide desktop window, set viewport instead.

Or set the screen yourself

Without device, the screen is 1,440 by 900 pixels.

viewportstringScreen size as WIDTHxHEIGHT, for example 1440x900. Shortcut for viewport_width and viewport_height.
viewport_widthintegerWidth of the browser window, in pixels. 320 to 3,840.default 1440
viewport_heightintegerHeight of the browser window, in pixels. With full_page, the image is taller than this. 320 to 2,160.default 900
devicestringCapture as this device (screen size, pixel density, mobile browser). One of desktop, desktop_hd, laptop, ipad, ipad_pro, ipad_mini, iphone_15, iphone_15_pro_max, iphone_se, pixel_8, galaxy_s24.
orientationstringHold a phone or a tablet upright (portrait) or on its side (landscape). Needs a phone or tablet device. One of portrait, landscape.default portrait
device_scale_factornumberPixel density. 2 gives a sharper, larger image. 1 to 3.default 1
color_schemestringAsk the page for its light or dark theme. One of light, dark.
languagestringBrowser language, for example fr or fr-FR. Without it, a screenshot from a country uses the main language of that country.default en-US
timezonestringBrowser time zone, for example Europe/Paris. Without it, a screenshot from a country uses the main time zone of that country.
user_agentstringUser-Agent the page receives. A preset (googlebot, googlebot_mobile) or your own string. Useful to compare what a site shows to a crawler and to a visitor. A site that checks the crawler's IP address is not fooled. Up to 300 characters.
countrystringLoad the page from this country (ISO 3166-1 alpha-2 code, see /v1/countries). The response reports the country actually observed. If it cannot be obtained, the request fails and is not charged. Costs 2 credits instead of 1.

viewport=1280x720 is a shortcut for viewport_width=1280 and viewport_height=720.

The whole page, or one element

Dark mode, language, time zone

These change what the browser says about itself. They do not change where the page is loaded from: for that, see Countries and attestation.