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.
| Id | Device | Viewport | Frame |
|---|---|---|---|
| desktop | Desktop | 1440 × 1000 | laptop |
| macbook-air-13 | MacBook Air 13″ | 1470 × 956 | MacBook |
| macbook-pro-14 | MacBook Pro 14″ | 1512 × 982 | MacBook |
| imac-24 | iMac 24″ | 2240 × 1260 | iMac |
| studio-display | Studio Display | 2560 × 1440 | Studio Display |
| iphone-17-pro | iPhone 17 Pro / 17 / 16 Pro | 402 × 874 | iPhone |
| iphone-16 | iPhone 16 / 15 / 15 Pro | 393 × 852 | iPhone |
| iphone-se | iPhone SE | 375 × 667 | iPhone |
| ipad-pro-13 | iPad Pro 13″ | 1032 × 1376 | iPad |
| ipad-air-11 | iPad Air 11″ / iPad | 820 × 1180 | iPad |
| android | Android phone | 412 × 915 | Android 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?
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
fullPageset, 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
mobileandtabletpresets use an iPhone and an iPad frame, and thehd,full-hdandqhdpresets 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.