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.
desktop
desktop_hd
laptop
ipad
ipad_pro
ipad_mini
iphone_15
iphone_15_pro_max
iphone_se
pixel_8
galaxy_s24
Or set the screen yourself
Without device, the screen is 1,440 by 900 pixels.
viewportstring
Screen size as WIDTHxHEIGHT, for example 1440x900. Shortcut for viewport_width and viewport_height.
viewport_widthinteger
Width of the browser window, in pixels. 320 to 3,840.default 1440
viewport_heightinteger
Height of the browser window, in pixels. With full_page, the image is taller than this. 320 to 2,160.default 900
devicestring
Capture 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.
device_scale_factornumber
Pixel density. 2 gives a sharper, larger image. 1 to 3.default 1
color_schemestring
Ask the page for its light or dark theme. One of light, dark.
languagestring
Browser language, for example fr or fr-FR.default en-US
timezonestring
Browser time zone, for example Europe/Paris.
countrystring
Load 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
full_page=true captures the page from top to bottom. The image is as wide as the screen and as tall as the page. We scroll the page first, so images that load late are in the picture.
selector captures only the first element that matches a CSS selector, for example #pricing or .chart. If nothing matches, the screenshot fails with selector_not_found.
They cannot be used together.
Dark mode, language, time zone
color_scheme=dark asks the page for its dark theme. A page that has none stays as it is.
language sets the browser language, for example fr or fr-FR. A site that follows it answers in that language.
timezone sets the browser clock, for example Europe/Paris.
These change what the browser says about itself. They do not change where the page is loaded from: for that, see Countries and attestation.