List Devices

Retrieve all available device presets for viewport emulation.

Endpoint

GET https://api.renderscreenshot.com/v1/devices

Authentication

Include your API key in the Authorization header:

Authorization: Bearer rs_live_xxxxx

Response

{
  "devices": [
    {
      "id": "iphone_14_pro",
      "name": "iPhone 14 Pro",
      "viewport": { "width": 390, "height": 844 },
      "scale": 3,
      "mobile": true,
      "touch": true
    },
    {
      "id": "iphone_14_pro_max",
      "name": "iPhone 14 Pro Max",
      "viewport": { "width": 430, "height": 932 },
      "scale": 3,
      "mobile": true,
      "touch": true
    },
    {
      "id": "pixel_7",
      "name": "Google Pixel 7",
      "viewport": { "width": 412, "height": 915 },
      "scale": 2.625,
      "mobile": true,
      "touch": true
    },
    {
      "id": "ipad_pro_12",
      "name": "iPad Pro 12.9\"",
      "viewport": { "width": 1024, "height": 1366 },
      "scale": 2,
      "mobile": true,
      "touch": true
    },
    {
      "id": "macbook_pro_14",
      "name": "MacBook Pro 14\"",
      "viewport": { "width": 1512, "height": 982 },
      "scale": 2,
      "mobile": false,
      "touch": false
    }
  ]
}

Device Properties

Property	Type	Description
`id`	string	Device identifier to use in requests
`name`	string	Human-readable device name
`viewport.width`	integer	Screen width in CSS pixels
`viewport.height`	integer	Screen height in CSS pixels
`scale`	number	Device pixel ratio
`mobile`	boolean	Whether to emulate mobile behavior
`touch`	boolean	Whether touch events are enabled

Using Device Presets

Specify a device in your screenshot request:

POST Request

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

GET Request

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

Example

curl https://api.renderscreenshot.com/v1/devices \
  -H "Authorization: Bearer rs_live_xxxxx"

Combining Device with Other Options

Device presets set viewport, scale, mobile, and touch automatically. You can override individual settings:

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

This uses iPhone 14 Pro settings but switches to landscape orientation (844x390).