Capture websites on any device
Set viewport size, device pixel ratio, or use a device preset to emulate any screen: iPhone, iPad, 4K desktop, and more.
Manual dimensions
Set viewport_width and viewport_height to any custom size. Default: 1280 × 800.
Device presets
Pass viewport_device to emulate a real device. It sets width, height, scale, mobile flag, and touch support automatically. Available: iphone-12, iphone-14, iphone-se, ipad, ipad-pro, ipad-mini, galaxy-s21, pixel-7, macbook-air, desktop-1080, desktop-1440, desktop-4k.
Resolution presets
resolution shorthand: 720p → 1280×720, 1080p → 1920×1080, 1440p/2k → 2560×1440, 4k → 3840×2160.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
viewport_width | integer | optional | Viewport width in pixels (320–3840). Default: 1280. |
viewport_height | integer | optional | Viewport height in pixels (240–2160). Default: 800. |
device_scale_factor | number | optional | Device pixel ratio (1–3). Use 2 or 3 for retina/HiDPI output. Default: 1. |
viewport_mobile | boolean | optional | Emulate a mobile browser. Default: false. |
viewport_has_touch | boolean | optional | Enable touch event emulation. Default: false. |
viewport_landscape | boolean | optional | Swap width and height (landscape). Default: false. |
viewport_device | string | optional | Device preset name. Overrides width/height/scale/mobile/touch. E.g. iphone-14, ipad-pro, galaxy-s21. |
resolution | string | optional | Resolution shorthand: 720p, 1080p, 1440p, 2k, or 4k. Overrides viewport_width/height. |
Code Examples
# iPhone 14 device preset
curl "https://screenshotcore.com/api/v1/screenshot?access_key=KEY&url=https://example.com&viewport_device=iphone-14" -o iphone.png
# 4K resolution preset
curl "https://screenshotcore.com/api/v1/screenshot?access_key=KEY&url=https://example.com&resolution=4k" -o 4k.png
# Custom retina viewport
curl "https://screenshotcore.com/api/v1/screenshot?access_key=KEY&url=https://example.com&viewport_width=1440&viewport_height=900&device_scale_factor=2" -o retina.pngResponse
(Raw PNG bytes at the requested viewport size, Content-Type: image/png)