1# Browser Rendering API
2 
3## REST API
4 
5**Base:** `https://api.cloudflare.com/client/v4/accounts/{accountId}/browser-rendering`  
6**Auth:** `Authorization: Bearer <token>` (Browser Rendering - Edit permission)
7 
8### Endpoints
9 
10| Endpoint | Description | Key Options |
11|----------|-------------|-------------|
12| `/content` | Get rendered HTML | `url`, `waitUntil` |
13| `/screenshot` | Capture image | `screenshotOptions: {type, fullPage, clip}` |
14| `/pdf` | Generate PDF | `pdfOptions: {format, landscape, margin}` |
15| `/snapshot` | HTML + inlined resources | `url` |
16| `/scrape` | Extract by selectors | `selectors: ["h1", ".price"]` |
17| `/json` | AI-structured extraction | `schema: {name: "string", price: "number"}` |
18| `/links` | Get all links | `url` |
19| `/markdown` | Convert to markdown | `url` |
20 
21```bash
22curl -X POST '.../browser-rendering/screenshot' \
23  -H "Authorization: Bearer $TOKEN" \
24  -d '{"url":"https://example.com","screenshotOptions":{"fullPage":true}}'
25```
26 
27## Workers Binding
28 
29```jsonc
30// wrangler.jsonc
31{ "browser": { "binding": "MYBROWSER" } }
32```
33 
34## Puppeteer
35 
36```typescript
37import puppeteer from "@cloudflare/puppeteer";
38 
39const browser = await puppeteer.launch(env.MYBROWSER, { keep_alive: 600000 });
40const page = await browser.newPage();
41await page.goto('https://example.com', { waitUntil: 'networkidle0' });
42 
43// Content
44const html = await page.content();
45const title = await page.title();
46 
47// Screenshot/PDF
48await page.screenshot({ fullPage: true, type: 'png' });
49await page.pdf({ format: 'A4', printBackground: true });
50 
51// Interaction
52await page.click('#button');
53await page.type('#input', 'text');
54await page.evaluate(() => document.querySelector('h1')?.textContent);
55 
56// Session management
57const sessions = await puppeteer.sessions(env.MYBROWSER);
58const limits = await puppeteer.limits(env.MYBROWSER);
59 
60await browser.close();
61```
62 
63## Playwright
64 
65```typescript
66import { launch, connect } from "@cloudflare/playwright";
67 
68const browser = await launch(env.MYBROWSER, { keep_alive: 600000 });
69const page = await browser.newPage();
70 
71await page.goto('https://example.com', { waitUntil: 'networkidle' });
72 
73// Modern selectors
74await page.locator('.button').click();
75await page.getByText('Submit').click();
76await page.getByTestId('search').fill('query');
77 
78// Context for isolation
79const context = await browser.newContext({
80  viewport: { width: 1920, height: 1080 },
81  userAgent: 'custom'
82});
83 
84await browser.close();
85```
86 
87## Session Management
88 
89```typescript
90// List sessions
91await puppeteer.sessions(env.MYBROWSER);
92 
93// Connect to existing
94await puppeteer.connect(env.MYBROWSER, sessionId);
95 
96// Check limits
97await puppeteer.limits(env.MYBROWSER);
98// { remaining: ms, total: ms, concurrent: n }
99```
100 
101## Key Options
102 
103| Option | Values |
104|--------|--------|
105| `waitUntil` | `load`, `domcontentloaded`, `networkidle0`, `networkidle2` |
106| `keep_alive` | Max 600000ms (10 min) |
107| `screenshot.type` | `png`, `jpeg` |
108| `pdf.format` | `A4`, `Letter`, `Legal` |
109