Device Frame Screenshot API: Website Mockups in iPhone, iPad and MacBook Frames

Last updated:

URLBooth can place a website screenshot inside a device frame in a single API call. Send "frame": true with a device id such as iphone-17-pro or macbook-pro-14, and the response is a mockup image of that page in the matching iPhone, iPad, MacBook, iMac, monitor or Android phone.

How does the frame option work?

The page is captured at the device viewport, then composed into hardware artwork that matches the device family. The frame is chosen from the device you pass, so there is no separate frame setting to pick. Because the frame also takes up part of the screen (a status bar on phones, a menu bar and browser toolbar on desktops), the page is rendered in the space left inside it. The image you get back is larger than the plain viewport.

Frame is a boolean and defaults to false. Output formats work as in the options reference.

Which devices have frames?

Every one of the 30 device presets has a frame: 8 iPhone, 6 iPad, 6 Mac, 2 Android and 8 standard viewports, which use a laptop, monitor, tablet or phone frame. The table shows a representative set; the full device list is in the docs.

IdDeviceViewportFrame
desktopDesktop1440 × 1000laptop
macbook-air-13MacBook Air 13″1470 × 956MacBook
macbook-pro-14MacBook Pro 14″1512 × 982MacBook
imac-24iMac 24″2240 × 1260iMac
studio-displayStudio Display2560 × 1440Studio Display
iphone-17-proiPhone 17 Pro / 17 / 16 Pro402 × 874iPhone
iphone-16iPhone 16 / 15 / 15 Pro393 × 852iPhone
iphone-seiPhone SE375 × 667iPhone
ipad-pro-13iPad Pro 13″1032 × 1376iPad
ipad-air-11iPad Air 11″ / iPad820 × 1180iPad
androidAndroid phone412 × 915Android phone

What do the frames look like?

Frames follow the hardware family rather than a generic border. Recent iPhones such as iphone-17-pro and iphone-16 get a Dynamic Island, older ones such as iphone-16e a notch, and iphone-se a home button. iPads include current models and the home-button ipad-classic. MacBook Air and Pro frames have a notch and a menu bar, and the imac-24 and studio-display presets draw a desktop display. Android presets use an Android phone frame.

How do I request a framed screenshot?

Device frame curl example
curl --fail-with-body "https://urlbooth.com/v1/screenshots" \
-H "Authorization: Bearer $URLBOOTH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","device":"iphone-17-pro","frame":true}' \
-o mockup.png

The API needs a Pro plan at $20 per month; see pricing. New to the endpoint? Start with how to take a website screenshot with an API.

What are device mockups useful for?

  • Documentation that shows a page the way users see it.
  • Changelogs and release notes with a before and after of a real URL.
  • Marketing and app store style images of a responsive site on a phone or tablet.
  • Client reports that show a deployed page on several devices.

For unframed phone and tablet images, see mobile website screenshots.

Limits and caveats

  • Frames are not available with full-page captures. With fullPage set, the frame is dropped and you get the plain full-page image.
  • The device inside the frame shows only the first screen of the page, at the device viewport.
  • Some presets share artwork. The generic mobile and tablet presets use an iPhone and an iPad frame, and the hd, full-hd and qhd presets use a monitor frame.
  • The framed image must stay within 10 MB and the same canvas limits as full-page captures, or the capture fails.
  • Plan limits apply: 10,000 a day, 60 a minute, 10 at once, with images stored for 2 days. Sites that block automated browsers can still fail.

Page cleanup also works with frames; see removing cookie banners. Details are in the API reference.