Device Emulation

Capture screenshots as they would appear on specific devices. Device emulation automatically configures viewport, user agent, touch capabilities, and pixel density.

Device Emulation Parameter

emulateDevice (`emulateDevice`)

Default: None
Example: emulateDevice=iphone_15_pro
Effect: Overrides viewport, user agent, and scale factor settings

Get Available Devices

Retrieve the complete list of supported devices:

curl "https://edge.capture.page/screenshot/devices"

Sample Response:

{
  "success": true,
  "count": 120,
  "devices": [
    {
      "name": "iPhone 15 Pro",
      "key": "iphone_15_pro",
      "viewport": { "width": 393, "height": 852, "deviceScaleFactor": 3 }
    }
  ]
}

Common Devices

Smartphones: iphone_15_pro, iphone_15, pixel_8, galaxy_s23

Tablets: ipad_pro_12_9, ipad_air, galaxy_tab_s9

Desktop: desktop_hd, laptop

For complete list: Use the /screenshot/devices API endpoint

Usage Examples

// iPhone
https://cdn.capture.page/KEY/HASH/image?url=https://example.com&emulateDevice=iphone_15_pro

// iPad
&emulateDevice=ipad_air

// Desktop
&emulateDevice=desktop_hd

What's Included

Device emulation automatically configures:

Viewport dimensions (exact screen size)
Device scale factor (pixel density)
User agent string
Touch capabilities
Mobile-optimized rendering

Best Practices

Use real device profiles:

✅ emulateDevice=iphone_15_pro
❌ vw=393&vh=852&scaleFactor=3 (manual viewport)

Match your audience: Use iPhone for iOS users, Pixel/Galaxy for Android users.

Troubleshooting

Device Not Found: Check /screenshot/devices endpoint for correct key

Unexpected Layout: Device emulation triggers mobile/tablet layouts, site may detect and redirect

Wrong Screen Size: Device emulation overrides manual viewport settings