Web render

Point at a public web page and get back a rendered artifact — a PDF, a screenshot image, or the page’s clean article text — from a single API call. Backed by a headless browser worker; each call is priced flat. Every URL is SSRF-guarded: only public http/https URLs are fetched; private, loopback, and cloud-metadata addresses are refused.

curl -X POST https://api.relaystation.ai/v1/web/pdf \
  -H 'Authorization: Bearer rs_live_<key>' \
  -H 'Idempotency-Key: web-pdf-20260707' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://example.com/article" }'

Or on the lodestone path — no account, a signed x402 payment instead of an API key:

curl -X POST https://api.relaystation.ai/v1/web/pdf \
  -H 'X-Payment: <base64 EIP-3009 authorization>' \
  -H 'Idempotency-Key: web-pdf-20260707' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://example.com/article" }'

pdf — render a URL to PDF

POST /v1/web/pdf. The page is loaded in a headless browser and printed to PDF.

Field	Type	Notes
`url`	string, required	a public `http`/`https` URL (≤ 4096 chars)
`viewport`	`{ width, height }`	render viewport in px (each 1–10000)
`fullPage`	boolean	capture the full scroll height
`waitMs`	integer	extra settle time before capture, 0–20000 ms
`pdfOptions`	object	page-format / margin controls

Returns the rendered PDF in the uniform JSON output envelope (inline when small, a presigned URL when large — see Passing & receiving files).

screenshot — capture a URL as an image

POST /v1/web/screenshot.

Field	Type	Notes
`url`	string, required	a public `http`/`https` URL
`type`	enum	`png` \| `jpeg` \| `webp`
`viewport`	`{ width, height }`	render viewport in px
`fullPage`	boolean	capture the full scroll height
`waitMs`	integer	extra settle time, 0–20000 ms

curl -X POST https://api.relaystation.ai/v1/web/screenshot \
  -H 'Authorization: Bearer rs_live_<key>' \
  -H 'Idempotency-Key: web-shot-20260707' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://example.com", "type": "png", "fullPage": true }'

Returns the screenshot image in the uniform output envelope.

readability — clean article text

POST /v1/web/readability strips the chrome, ads, and navigation and returns the article body.

curl -X POST https://api.relaystation.ai/v1/web/readability \
  -H 'Authorization: Bearer rs_live_<key>' \
  -H 'Idempotency-Key: web-read-20260707' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://example.com/article" }'

Returns { title, byline, excerpt, textContent, length }.

SSRF guard — read this before you rely on it

Every URL is validated before the fetch and again at the egress point. Only public http/https URLs are allowed; requests to private ranges, loopback (127.0.0.1, localhost), link-local, and cloud metadata addresses (e.g. 169.254.169.254) are blocked and return a 422 before any charge. By default the render fetches same-origin only — the page’s own resources, not arbitrary cross-origin assets. This is a deliberate wall: it stops the renderer from being turned into a proxy into a private network.

Billing

Each op is a flat per-call charge: pdf bills per render, screenshot bills per screenshot, readability bills per extract. A URL blocked by the SSRF guard returns a 422 and is not charged. Priced per call; see Pricing for the current rates, or send an unauthenticated POST to read the exact price from the 402 challenge. Every billable call needs an Idempotency-Key; a same-key retry returns the cached result without re-charging.

MCP tools

Callable over MCP at https://api.relaystation.ai/mcp: url_to_pdf, url_screenshot, and url_readability. Same auth, same prices as the HTTP routes.

Passing & receiving files · PDF tools · Quickstart · x402 wire format · API reference