Custom Viewports

Device emulation and responsive testing

Capture screenshots at any viewport size or use device presets to emulate real devices. Perfect for responsive design testing and multi-device compatibility checks.

Quick Start

Set viewport dimensions with viewport_width and viewport_height:

Custom Viewport•bash

curl -X POST https://www.snapshotai.dev/api/v1/screenshots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "options": {
      "viewport_width": 1920,
      "viewport_height": 1080
    }
  }'

Device Presets

Use the device parameter to automatically configure viewport, user agent, and device pixel ratio:

Device Preset•bash

curl -X POST https://www.snapshotai.dev/api/v1/screenshots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "options": {
      "device": "iphone-15-pro-max"
    }
  }'

Automatic Configuration

Device presets automatically set viewport size, user agent string, and device scale factor. No need to specify individual parameters.

Desktop & Laptop Devices

Default Desktop

1920 × 1080

default

Desktop 1080p

1920 × 1080

desktop-1080p

Desktop 1440p

2560 × 1440

desktop-1440p

Desktop 4K

3840 × 2160

desktop-4k

MacBook Pro 16"

1728 × 1117

macbook-pro-16

MacBook Air 13"

1470 × 956

macbook-air-13

iPhone Devices

iPhone 15 Pro Max

430 × 932

iphone-15-pro-max

iPhone 15 Pro

393 × 852

iphone-15-pro

iPhone 14 Pro Max

430 × 932

iphone-14-pro-max

iPhone 14 Pro

393 × 852

iphone-14-pro

iPhone 13

390 × 844

iphone-13

iPhone 12

390 × 844

iphone-12

iPhone SE

375 × 667

iphone-se

Samsung Galaxy Devices

Samsung S25 Ultra

412 × 915

samsung-s25-ultra

Samsung S25+

384 × 854

samsung-s25-plus

Samsung S25

360 × 800

samsung-s25

Samsung S24 Ultra

412 × 915

samsung-s24-ultra

Samsung S23 Ultra

412 × 915

samsung-s23-ultra

Samsung S22

360 × 800

samsung-s22

Samsung A54

360 × 800

samsung-a54

Google Pixel Devices

Pixel 10 Pro

412 × 915

pixel-10-pro

Pixel 10

412 × 915

pixel-10

Pixel 9 Pro XL

412 × 892

pixel-9-pro-xl

Pixel 9 Pro

384 × 831

pixel-9-pro

Pixel 9

384 × 831

pixel-9

Pixel 8 Pro

412 × 892

pixel-8-pro

Pixel 8

412 × 915

pixel-8

Pixel 7 Pro

412 × 892

pixel-7-pro

Pixel 7

412 × 915

pixel-7

Tablet Devices

iPad Pro 13"

1032 × 1376

ipad-pro-13

iPad Pro 12.9"

1024 × 1366

ipad-pro-12.9

iPad Air

820 × 1180

ipad-air

iPad Mini

768 × 1024

ipad-mini

Galaxy Tab S11 Ultra

1024 × 1536

samsung-tab-s11-ultra

Galaxy Tab S11+

800 × 1280

samsung-tab-s11-plus

Galaxy Tab S11

800 × 1280

samsung-tab-s11

Galaxy Tab S10 Ultra

1024 × 1536

samsung-tab-s10-ultra

Galaxy Tab S10+

800 × 1280

samsung-tab-s10-plus

Galaxy Tab S10

800 × 1280

samsung-tab-s10

Galaxy Tab S9

800 × 1280

samsung-tab-s9

Pixel Tablet

1600 × 2560

pixel-tablet

Advanced Options

Fine-tune viewport behavior with additional parameters:

Advanced Viewport Configuration•bash

curl -X POST https://www.snapshotai.dev/api/v1/screenshots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "options": {
      "viewport_width": 1280,
      "viewport_height": 720,
      "device_scale_factor": 2,
      "viewport_mobile": true
    }
  }'

device_scale_factor

Device pixel ratio (1-3). Use 2 for Retina displays.

viewport_mobile

Enable mobile viewport meta tag behavior.

viewport_has_touch

Emulate touch screen capability.

viewport_landscape

Rotate viewport to landscape orientation.

Code Example

JavaScript - Using Device Preset•javascript

const response = await fetch('https://www.snapshotai.dev/api/v1/screenshots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com',
    options: {
      device: 'iphone-15-pro-max'
      // Device preset automatically sets viewport, user agent, and scale factor
    }
  })
});

Viewport Constraints

Min Width

320px

Max Width

3840px

Min Height

240px

Max Height

4320px

Best Practices

• Use device presets for accurate emulation of real devices
• Test responsive breakpoints - common: 320px, 768px, 1024px, 1920px
• Combine with full_page to capture entire scrollable content at specific width
• Use device_scale_factor for Retina/HiDPI displays
• Match user_agent when using custom viewports for accurate rendering

Quick Start

Set viewport dimensions with viewport_width and viewport_height:

Custom Viewport•bash

curl -X POST https://www.snapshotai.dev/api/v1/screenshots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "options": {
      "viewport_width": 1920,
      "viewport_height": 1080
    }
  }'

Device Presets

Use the device parameter to automatically configure viewport, user agent, and device pixel ratio:

Device Preset•bash

curl -X POST https://www.snapshotai.dev/api/v1/screenshots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "options": {
      "device": "iphone-15-pro-max"
    }
  }'

Automatic Configuration

Device presets automatically set viewport size, user agent string, and device scale factor. No need to specify individual parameters.

Tablet Devices

iPad Pro 13"

1032 × 1376

ipad-pro-13

iPad Pro 12.9"

1024 × 1366

ipad-pro-12.9

iPad Air

820 × 1180

ipad-air

iPad Mini

768 × 1024

ipad-mini

Galaxy Tab S11 Ultra

1024 × 1536

samsung-tab-s11-ultra

Galaxy Tab S11+

800 × 1280

samsung-tab-s11-plus

Galaxy Tab S11

800 × 1280

samsung-tab-s11

Galaxy Tab S10 Ultra

1024 × 1536

samsung-tab-s10-ultra

Galaxy Tab S10+

800 × 1280

samsung-tab-s10-plus

Galaxy Tab S10

800 × 1280

samsung-tab-s10

Galaxy Tab S9

800 × 1280

samsung-tab-s9

Pixel Tablet

1600 × 2560

pixel-tablet

Advanced Options

Fine-tune viewport behavior with additional parameters:

Advanced Viewport Configuration•bash

curl -X POST https://www.snapshotai.dev/api/v1/screenshots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "options": {
      "viewport_width": 1280,
      "viewport_height": 720,
      "device_scale_factor": 2,
      "viewport_mobile": true
    }
  }'

device_scale_factor

Device pixel ratio (1-3). Use 2 for Retina displays.

viewport_mobile

Enable mobile viewport meta tag behavior.

viewport_has_touch

Emulate touch screen capability.

viewport_landscape

Rotate viewport to landscape orientation.

Code Example

JavaScript - Using Device Preset•javascript

const response = await fetch('https://www.snapshotai.dev/api/v1/screenshots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com',
    options: {
      device: 'iphone-15-pro-max'
      // Device preset automatically sets viewport, user agent, and scale factor
    }
  })
});