Device emulation

Ssnap ships 131 device presets mirroring Puppeteer's device list: phones, tablets and their landscape variants, each with a user agent and a screen size. Captures emulate the selected device.

Choosing a device

Pass device_id:

curl -G https://ssnap.cc/api/v1/screenshot \
  -H "Authorization: Bearer $SSNAP_API_KEY" \
  --data-urlencode "url=https://example.com" \
  --data-urlencode "device_id=42"

The ids are assigned when the preset catalogue is imported. The current list, with names and dimensions, is shown in the device picker on the Screenshots page of your dashboard. Use it to find the id you want.

Omitting device_id uses the server's configured default preset. An unknown id is rejected with 422 and code invalid_device.

Preset families

Each preset carries its own type (mobile or tablet), user agent and screen size.

Overriding the viewport

width and height are applied after the preset, so they override its dimensions:

curl -G https://ssnap.cc/api/v1/screenshot \
  -H "Authorization: Bearer $SSNAP_API_KEY" \
  --data-urlencode "url=https://example.com" \
  --data-urlencode "width=1920" \
  --data-urlencode "height=1080"

The device's user agent still applies after a viewport override, so you get the preset UA plus custom dimensions. To capture a desktop-sized page, set an explicit width/height.

Full page and devices

full_page=true captures the entire scroll height at the selected width, so the device preset controls the width and the page controls the height. See Full page and element captures.

Rendering environment

Every capture runs in headless Chromium with:

• locale en-GB,
• a 30-second render timeout,
• dialogs auto-dismissed, so alert() or cookie confirm() popups cannot hang a render,
• ad, analytics and Google Fonts requests blocked (googlesyndication.com, google-analytics.com, fonts.googleapis.com) to cut render time and noise.

Next