Devices Reference

Device presets emulate specific devices with accurate viewport dimensions, device pixel ratio, and mobile/touch settings.

Using Device Presets

POST Request

{
  "url": "https://example.com",
  "viewport": {
    "device": "iphone_14_pro"
  }
}

GET Request

GET /v1/screenshot?url=https://example.com&device=iphone_14_pro

With Landscape

{
  "viewport": {
    "device": "iphone_14_pro",
    "landscape": true
  }
}

iPhone Devices

iphone14pro

{ "viewport": { "device": "iphone_14_pro" } }

iphone14pro_max

{ "viewport": { "device": "iphone_14_pro_max" } }

iphone_14

{ "viewport": { "device": "iphone_14" } }

iphone_13

{ "viewport": { "device": "iphone_13" } }

iphone_12

{ "viewport": { "device": "iphone_12" } }

iphone_se

{ "viewport": { "device": "iphone_se" } }

Android Devices

pixel_7

{ "viewport": { "device": "pixel_7" } }

pixel7pro

{ "viewport": { "device": "pixel_7_pro" } }

pixel_6

{ "viewport": { "device": "pixel_6" } }

samsunggalaxys21

{ "viewport": { "device": "samsung_galaxy_s21" } }

iPad Devices

ipadpro12

{ "viewport": { "device": "ipad_pro_12" } }

ipadpro11

{ "viewport": { "device": "ipad_pro_11" } }

ipad_air

{ "viewport": { "device": "ipad_air" } }

ipad_mini

{ "viewport": { "device": "ipad_mini" } }

Desktop Devices

macbookpro14

{ "viewport": { "device": "macbook_pro_14" } }

macbookpro16

{ "viewport": { "device": "macbook_pro_16" } }

macbook_air

{ "viewport": { "device": "macbook_air" } }

Device Comparison Table

Device Properties Explained

Output Resolution

The actual output image size is: viewport × scale

For example, iPhone 14 Pro: - Viewport: 390 × 844 - Scale: 3x - Output: 1170 × 2532 pixels

Custom Devices

For devices not in the preset list, use custom viewport settings:

{
  "viewport": {
    "width": 400,
    "height": 900,
    "scale": 2.5,
    "mobile": true,
    "touch": true
  }
}

See Also

• List Devices Endpoint - Get devices via API
• Viewport Options - Custom viewport configuration
• Presets Reference - Mobile preset