ProdaPic API

URL → Screenshot · v3.1

ProdaPic captures any webpage as PNG, JPEG, WEBP, or PDF. It supports viewport, full-page, and element-level capture with device simulation and ad blocking.

Base URL
api.scaleapis.com
Version
v3.1
Protocol
HTTPS only
Formats
4 outputs

Authentication

All requests require a Bearer token. Manage keys at API Keys dashboard.

Authorization header
Authorization: Bearer sk_live_••••••••

Capture Modes

Full-Page

Capture the entire scrollable page by setting full_page: true.

{ "full_page": true }

Viewport

Capture only the visible viewport. Default mode.

{ "full_page": false }

Element

Capture a specific DOM element by CSS selector.

{ "selector": "#chart" }

Device Preset

Simulate a real device viewport and user agent.

{ "device": "iphone14" }

Parameters

Parameter
Type
Required
Description
url
string
Required
The URL to capture.
format
string
Optional
png | jpeg | webp | pdf. Default: png.
width
integer
Optional
Viewport width. Default: 1440.
height
integer
Optional
Viewport height. Default: 900.
full_page
boolean
Optional
Capture the full scrollable page. Default: false.
selector
string
Optional
CSS selector for element-level capture.
device
string
Optional
Device preset: iphone14, ipad, pixel7, macbook15.
block_ads
boolean
Optional
Block ads and cookie banners. Default: false.
wait_for
string
Optional
CSS selector to wait before capture.
delay
integer
Optional
Delay in ms after page load before capture.

Roadmap

ProdaPic is launching with the capture features listed above. Additional output formats, scheduled captures, and customer-controlled visual analysis integrations are roadmap candidates after the SaaS control plane, billing, and gateway are fully live.

POST /v1/screenshot
{
  "url": "https://competitor.com/pricing",
  "format": "png",
  "full_page": true,
  "block_ads": true
}

// Response includes screenshot metadata or a binary capture depending on mode
{
  "screenshot_url": "https://cdn.scaleapis.com/snaps/abc.png",
  "format": "png"
}

Error Codes

400
Bad Request

Missing url or invalid parameter.

401
Unauthorized

Missing or invalid Bearer token.

403
Forbidden

URL blocked by content policy.

422
Unprocessable Entity

Page loaded but capture failed.

429
Too Many Requests

Rate limit exceeded.

500
Internal Server Error

Rendering engine error.

Rate Limits

Free
50 req/day
Pro
2,000 req/day
Enterprise
Custom

Upgrade your plan for higher rate limits and production access.