PDF API

Generate a PDF from any URL using Browser Rendering and Puppeteer's page.pdf() API.

API ReferenceCopy Anchor Link

GET /pdfCopy Anchor Link

Renders the specified URL in a headless browser and returns a PDF document.

Example RequestCopy Anchor Link

curl "https://your-worker.workers.dev/pdf?url=https://www.cloudflare.com" \
  --output page.pdf

Success ResponseCopy Anchor Link

Returns a PDF file with the following headers:

Content-Type: application/pdf
Cache-Control: public, max-age=60

Error ResponseCopy Anchor Link

{
  "error": "Missing or invalid query parameter: url",
  "code": "INVALID_URL"
}

Error CodesCopy Anchor Link

• 400 - Missing or invalid url parameter (not http/https)
• 502 - PDF generation failed (PDF_ERROR)

Use CasesCopy Anchor Link

• Convert web pages to printable PDF documents
• Archive rendered page content with styles
• Generate invoices or reports from HTML pages
• Learn Browser Rendering PDF generation with Workers bindings

LimitationsCopy Anchor Link

• Requires Browser Rendering enabled on your Cloudflare account
• Local development needs npx wrangler dev --remote
• Navigation timeout; complex or infinite-scroll pages may fail
• Fixed viewport; no PDF margin, format, or page-size options

Use in your projectCopy Anchor Link

import puppeteer from "@cloudflare/puppeteer";import type { Page } from "@cloudflare/puppeteer";import { DEFAULT_VIEWPORT, NAVIGATION_TIMEOUT_MS } from "../constants/defaults";export async function withBrowserPage<T>(  browserBinding: Fetcher,  url: string,  fn: (page: Page) => Promise<T>): Promise<T> {  let browser: Awaited<ReturnType<typeof puppeteer.launch>> | null = null;  try {    browser = await puppeteer.launch(browserBinding);    const page = await browser.newPage();    await page.setViewport(DEFAULT_VIEWPORT);    await page.goto(url, {      waitUntil: "networkidle0",      timeout: NAVIGATION_TIMEOUT_MS,    });    return await fn(page);  } finally {    if (browser) {      try {        await browser.close();      } catch {        /* ignore close errors */      }    }  }}export async function generatePdf(browserBinding: Fetcher, url: string): Promise<Uint8Array> {  return withBrowserPage(browserBinding, url, async (page) => {    const pdf = await page.pdf({ printBackground: true });    return new Uint8Array(pdf);  });}

DeploymentCopy Anchor Link

curl "https://your-worker.workers.dev/pdf?url=https://www.cloudflare.com" \
  --output page.pdf

Local DevelopmentCopy Anchor Link

cd apps/experiments/pdf-api
npm install
npm run dev

Test locally:

curl "http://localhost:8787/pdf?url=https://www.cloudflare.com" --output test.pdf

Cloudflare Features UsedCopy Anchor Link

• Workers - Edge compute runtime
• Browser Rendering - Headless Chromium via @cloudflare/puppeteer
• Puppeteer page.pdf() - PDF generation from rendered pages