Screenshots

The Screenshot API captures full-page or viewport screenshots of any URL. Like the Web Scraping API, it uses a real browser with smart readiness detection to ensure the page is fully rendered before capture.

Key features

• Multiple formats — PNG, JPEG, or WebP output
• Custom viewports — set exact width and height (320–3840 x 240–2160)
• Full-page capture — capture the entire scrollable page, not just the viewport
• Quality control — adjust JPEG/WebP quality (1–100)
• Smart readiness — same readiness detection as the Web Scraping API
• Proxy support — datacenter and residential proxies for accessing restricted sites

Planned usage

curl -X POST https://api.pagepry.com/v1/screenshot \
  -H "x-api-key: pp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "viewport": {"width": 1280, "height": 720},
    "format": "png",
    "fullPage": false
  }'

Planned response

{
  "success": true,
  "imageUrl": "https://cdn.pagepry.com/screenshots/abc123.png",
  "metadata": {
    "statusCode": 200,
    "url": "https://example.com",
    "resolvedUrl": "https://example.com/",
    "format": "png",
    "width": 1280,
    "height": 720,
    "loadTimeMs": 1200
  }
}

See the API Reference for the full schema.