PRODUCT / GENERATION & CONVERSION

URL to PDF API

Print a public HTTPS URL to PDF with Chromium via POST /v1/pdf. Private, loopback, and metadata hosts are blocked; failed jobs are not billed.

Read the implementation guide
DOCUMENT / 001PDF · A4
a.Acme StudioDesign with intention.

Invoice

INV—2026—042
September 07, 2026
Northstar Labs

120 Market Street
San Francisco, CA 94103

Due September 21, 2026
USD · Bank transfer

DESCRIPTIONQTYAMOUNT
Brand identity system1$2,400.00
Website design1$4,800.00
Development handoff1$1,200.00
Subtotal$8,400.00
Tax (0%)$0.00
Total due$8,400.00
Thank you for building with us.01 / 01
templateData{ "total": 8400 }
invoice.pdfSample output · ready to inspect
HTML + DATAPRODUCTION PDF

Use URL mode when the page already lives on a public http(s) host and you need a PDF at request time. Private, loopback, and metadata hosts are rejected. For HTML you control, send html instead. For a screenshot, use POST /v1/images. url must be public http(s). Private, loopback, and metadata hosts return url_not_allowed.

When to use it

Use URL mode when you already host the page and need capture at request time.

  • • Public http/https URLs only
  • • Private, localhost, metadata, and RFC1918 hosts are blocked
  • • Same options as HTML mode

Operational model

Successful jobs debit wallet cents. Failed jobs and rate-limited requests are unbilled.

curl

Generate a PDF from a URL.

POST /v1/pdf
curl https://api.relaypdf.com/v1/pdf \
  -H "Authorization: Bearer pdf_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","response":"binary"}' \
  --output page.pdf