Skip to content

AgentaOS/snapshot-api

Repository files navigation

Snapshot API

Capture screenshots of any webpage on 15 different devices with a single API call.

What it does

Send a URL and device type, get back a PNG screenshot. Perfect for:

  • Design previews - See how websites look on different devices
  • QA testing - Verify responsive layouts across screen sizes
  • Social sharing - Generate preview images for links
  • Archiving - Save visual snapshots of web pages
  • Monitoring - Track visual changes over time

Supported Devices

Mobile

iPhone 15 Pro, iPhone 15 Pro Max, iPhone 15, iPhone 14 Pro, iPhone 13 Pro, iPhone 12, Pixel 5, Galaxy S9+, iPad Pro, iPad Air

Desktop

HD (1366x768), Full HD (1920x1080), Laptop (1440x900), UltraWide (2560x1080), 4K (3840x2160)

How to use

Request:

{
  "url": "https://your-website.com",
  "device": "iphone-15-pro",
  "fullPage": false,
  "timeout": 15000,
  "delay": 3000
}

Response:

{
  "success": true,
  "url": "https://your-website.com",
  "device": "iPhone 15 Pro",
  "deviceKey": "iphone-15-pro",
  "type": "mobile",
  "description": null,
  "fullPage": false,
  "image": "data:image/png;base64,...",
  "timestamp": "2025-12-16T15:27:28.924Z"
}

Request Parameters

Parameter Required Default Description
url Yes - Website URL to capture (http/https)
device Yes - Device key to emulate (see list below)
fullPage No true Capture entire scrollable page or just viewport
timeout No 10000 Page load timeout in ms (5000-30000)
delay No 2000 Wait time after load for animations in ms (0-30000)

Response Fields

Field Type Description
success boolean Always true on success
url string The URL that was captured
device string Friendly device name (e.g. "iPhone 15 Pro")
deviceKey string Device key from request (e.g. "iphone-15-pro")
type string "mobile" or "desktop"
description string/null Resolution info for desktop, null for mobile
fullPage boolean Whether full page was captured
image string Base64-encoded PNG as data URL
timestamp string ISO 8601 timestamp of capture

Device Keys

iphone-15-pro, iphone-15-pro-max, iphone-15, iphone-14-pro,
iphone-13-pro, iphone-12, pixel-5, galaxy-s9, ipad-pro, ipad-air,
desktop-hd, desktop-fhd, desktop-laptop, desktop-ultrawide, desktop-4k

Examples

Mobile screenshot:

{"url": "https://example.com", "device": "iphone-15-pro"}

Desktop full page:

{"url": "https://example.com", "device": "desktop-fhd", "fullPage": true}

Wait for animations:

{"url": "https://example.com", "device": "ipad-pro", "delay": 5000}

Fast capture with longer timeout:

{"url": "https://slow-site.com", "device": "desktop-4k", "timeout": 25000, "delay": 0}

Pricing

Pay per request through the Agentokratia marketplace.

About

Capture screenshots of any webpage on 15 different devices with a single API call

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors