Devices

Add viewport_device and the page is drawn as that device would show it.

curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://en.wikipedia.org/wiki/Eiffel_Tower&viewport_device=iphone_15_pro" \
  --output eiffel-iphone.png

You get the mobile version of the article, in a file that is 1179 by 2556 pixels.

#What a device preset sets

A preset is a bundle of settings with a name. One value of viewport_device sets all of these:

Presets for phones and tablets turn on the mobile layout. Presets for laptops and desktops do not.

Without a preset, the page is drawn in a 1280 by 1024 window at density 1, as a desktop browser.

#Try a tablet

Change one word and you get a different device.

curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://en.wikipedia.org/wiki/Eiffel_Tower&viewport_device=ipad" \
  --output eiffel-ipad.png

The name is forgiving about spelling. iphone_15_pro, iphone-15-pro and iPhone 15 Pro all pick the same preset.

#Pixel density in one line

Pixel density multiplies the image size: a 393 x 852 viewport at density 3 gives a 1179 x 2556 image, with sharper text and the same layout.

That is why device screenshots are larger than the viewport numbers suggest. The option behind it is device_scale_factor. The default is 1. The largest value is 3. For full-page screenshots, your plan can set a lower maximum.

#Override part of a preset

Any viewport option you send yourself wins over the preset. The rest of the preset stays.

This keeps the iPhone layout and user agent, but asks for density 1, so the file is a light 393 by 852 pixels:

curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://en.wikipedia.org/wiki/Eiffel_Tower&viewport_device=iphone_15_pro&device_scale_factor=1" \
  --output eiffel-iphone-small.png

You can override these:

• viewport_width and viewport_height, for a taller or shorter first screen.
• device_scale_factor, for a lighter or sharper file.
• viewport_mobile, to turn the mobile layout on or off.
• user_agent, to send your own browser name.

#Landscape

Phone and tablet presets are in portrait, which means taller than wide. Add viewport_landscape=true to turn the device on its side.

curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://en.wikipedia.org/wiki/Eiffel_Tower&viewport_device=ipad&viewport_landscape=true" \
  --output eiffel-ipad-landscape.png

The iPad viewport becomes 1180 by 820 in place of 820 by 1180.

The default is false. On a preset that is already wider than tall, such as a laptop, it changes nothing.

#Without a preset

You do not need a preset to get a phone-sized screenshot. Set the numbers yourself:

curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://en.wikipedia.org/wiki/Eiffel_Tower&viewport_width=400&viewport_height=800&viewport_mobile=true&device_scale_factor=2" \
  --output eiffel-custom.png

viewport_mobile=true matters here. It makes the browser respect the page's own mobile settings, the way a phone does. Without it, a narrow window is still treated as a desktop browser.

The width can be from 100 to 3840 pixels. The height can be from 100 to 4320 pixels.

#All devices

#Phones

#Tablets

#Laptops

#Desktops

#Get the list as JSON

The same list is available from the API, for a device picker in your own app. This request needs no access key and does not count against your quota.

curl "https://curlshot.com/api/v1/devices"

{
  "devices": [
    {
      "name": "iphone_se",
      "label": "iPhone SE",
      "category": "phone",
      "viewport_width": 375,
      "viewport_height": 667,
      "device_scale_factor": 2,
      "viewport_mobile": true,
      "has_touch": true,
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1"
    }
  ]
}

The real answer holds one entry like this for every device in the tables above. category is phone, tablet, laptop or desktop.

#Where to go next

• Full-page screenshots: capture the whole page on any device.
• Dark mode and emulation: dark theme, time zone and user agent.
• Options reference: every viewport option with its limits.