API Docs — ShotFetch

Preview of the public screenshot API — built for reliability, full-page PNG/JPEG/PDF, and pay-for-success metering. Endpoints, auth, and rate limits finalize when founding packs unlock ($15 / $16 / $69). Join the waitlist for early access.

Base URL

https://api.shotfetch.example/v1

Placeholder host — production base URL ships with launch.

Authentication

Pass your API key via header:

Authorization: Bearer sf_live_…

Or query string for quick tests: ?api_key=sf_live_… (prefer header in production).

Capture a page

GET /v1/shot?url=https://example.com&format=png&full_page=true

Parameters

Param	Type	Default	Notes
`url`	string	required	Absolute http(s) URL to capture
`format`	string	`png`	`png` \| `jpeg` \| `pdf`
`full_page`	bool	`true`	Scroll full document height
`viewport_width`	int	`1280`	CSS pixels
`delay_ms`	int	`0`	Wait after load (cap TBD)

Example curl

curl -H "Authorization: Bearer sf_live_xxx" \
  "https://api.shotfetch.example/v1/shot?url=https://example.com&format=png" \
  -o shot.png

Response

On success: binary image/PDF with Content-Type matching format, or a JSON body with a short-lived download URL (final shape TBD).

Credits decrement only on successful renders.

Credit packs (planned)

Starter — 1,000 screenshots · $15
Builder — 2,000 · $16 (recommended for most teams)
Agency — 10,000 · $69

Credits roll until used. Founding waitlist: early access + 250 bonus credits on the first pack.

Errors

Code	Meaning
`400`	Invalid URL or parameters
`401`	Missing / invalid API key
`402`	Insufficient credits
`429`	Rate limited
`502 / 504`	Upstream render failure (not billed)

Rate limits

TBD per pack. Agency packs get higher concurrency. Exact numbers publish at launch.

Status

API live when founding packs unlock. Join the waitlist →

ShotFetch API