[Browser Rendering] quick actions API

public/_redirects

@@ -179,6 +179,11 @@
 /bots/reference/verified-bot-categories/ /bots/concepts/bot/verified-bots/categories/ 301
 /bots/reference/verified-bot-policy/ /bots/concepts/bot/verified-bots/policy/ 301
 
+#browser-rendering
+/browser-rendering/get-started/browser-rendering-with-DO/ /browser-rendering/workers-binding-api/browser-rendering-with-do/ 301   
+/browser-rendering/get-started/reuse-sessions/ /browser-rendering/workers-binding-api/reuse-sessions/ 301 
+/browser-rendering/get-started/screenshots/ /browser-rendering/workers-binding-api/screenshots/ 301  
+
 # byoip
 /byoip/about/dynamic-advertisement/ /byoip/concepts/dynamic-advertisement/ 301
 /byoip/best-practices/dynamic-advertisement/ /byoip/concepts/dynamic-advertisement/best-practices/ 301

src/content/docs/ai-gateway/guardrails/index.mdx

@@ -25,6 +25,7 @@ AI Gateway inspects all interactions in real time by evaluating content against
    AI Gateway proxies requests and responses, sitting between the user and the AI model.
 
 2. Inspecting content:
+
    - User prompts: AI Gateway checks prompts against safety parameters (for example, violence, hate, or sexual content). Based on your settings, prompts can be flagged or blocked before reaching the model.
    - Model responses: Once processed, the AI model response is inspected. If hazardous content is detected, it can be flagged or blocked before being delivered to the user.
 

src/content/docs/browser-rendering/get-started.mdx

@@ -0,0 +1,11 @@
+---
+pcx_content_type: navigation
+title: Get started
+sidebar:
+  order: 2
+---
+
+Browser rendering can be used in two ways:
+
+- [Workers Binding API](/browser-rendering/workers-binding-api) for complex scripts.
+- [Quick Actions REST API](/browser-rendering/quick-actions-rest-api/) for simple actions.

src/content/docs/browser-rendering/quick-actions-rest-api/content-endpoint.mdx

@@ -0,0 +1,41 @@
+---
+pcx_content_type: how-to
+title: Fetch HTML
+sidebar:
+  order: 2
+---
+
+The `/content` endpoint instructs the browser to navigate to a website and capture the fully rendered HTML of a page, including the `head` section, after JavaScript execution. This is ideal for capturing content from JavaScript-heavy or interactive websites.
+
+## Basic usage
+
+Go to `https://example.com` and return the rendered HTML.
+
+```bash
+curl -X 'POST' 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/content' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -d '{"url": "https://example.com"}'
+```
+
+## Advanced usage
+
+Navigate to `https://cloudflare.com/` but block images and stylesheets from loading. Undesired requests can be blocked by resource type (`rejectResourceTypes`) or by using a regex pattern (`rejectRequestPattern`).
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/content' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+      "url": "https://cloudflare.com/",
+  "rejectResourceTypes": ["image"],
+  "rejectRequestPattern": ["/^.*\\.(css)"]
+}
+
+```
+
+### Parameters
+
+- `url` _(string)_ - The URL of the webpage to extract content from.
+- `rejectResourceTypes` _(array)_ - Blocks specific resource types such as images, fonts from loading to improve performance.
+- `rejectRequestPattern` _(array of regex patterns)_ - Prevents loading of resources matching specified patterns such as CSS files.

src/content/docs/browser-rendering/quick-actions-rest-api/index.mdx

@@ -0,0 +1,21 @@
+---
+pcx_content_type: navigation
+title: Quick Actions REST API
+sidebar:
+  order: 2
+---
+
+The Quick Actions API is a RESTful interface that provides endpoints for common browser actions such as capturing screenshots, extracting HTML content, generating PDFs, and more.
+The following are the available options:
+
+import { DirectoryListing } from "~/components";
+
+<DirectoryListing />
+
+Use the Quick Actions API when you need a fast, simple way to perform common browser tasks such as capturing screenshots, extracting HTML, or generating PDFs without writing complex scripts. If you require more advanced automation, custom workflows, or persistent browser sessions, the [Workers Binding API](/browser-rendering/workers-binding-api/) is the better choice.
+
+Before you begin, make sure you [create a custom **API Token**](/fundamentals/api/get-started/create-token/):
+
+1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/).
+2. Go to your account, then select **Browser Rendering**.
+3. Select **Edit** permissions.

src/content/docs/browser-rendering/quick-actions-rest-api/pdf-endpoint.mdx

@@ -0,0 +1,86 @@
+---
+pcx_content_type: how-to
+title: Render PDF
+sidebar:
+  order: 5
+---
+
+The `/pdf` endpoint instructs the browser to render the webpage as a PDF document.
+
+## Basic usage
+
+Navigate to `https://example.com/` and inject custom CSS and an external stylesheet. Then return the rendered page as a PDF.
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/pdf' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/",
+    "addStyleTag": [
+      { "content": "body { font-family: Arial; }" },
+       { "url": "https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" }
+    ]
+  }' \
+  --output "output.pdf"
+```
+
+## Advanced usage
+
+Navigate to `https://example.com`, first setting an additional HTTP request header and configuring the page size (`viewport`). Then, wait until there are no more than 2 network connections for at least 500 ms, or until the maximum timeout of 4500 ms is reached, before considering the page loaded and returning the rendered PDF document.
+
+The `goToOptions` parameter exposes most of [Puppeteer'd API](https://pptr.dev/api/puppeteer.gotooptions).
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/pdf' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/",
+    "setExtraHTTPHeaders": {
+      "X-Custom-Header": "value"
+    },
+    "viewport": {
+      "width": 1200,
+      "height": 800
+    },
+    "gotoOptions": {
+      "waitUntil": "networkidle2",
+      "timeout": 45000
+    }
+  }' \
+  --output "advanced-output.pdf"
+```
+
+## PDF with no images or CSS
+
+Use PDF with no images or CSS if you want to accelerate the scanning process and you do not need the images.
+
+```bash
+curl -X POST https://api.cloudflare.com/client/v4/accounts/<acccountID>/browser-rendering/pdf \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+  "url": "https://cloudflare.com/",
+  "rejectResourceTypes": ["image"],
+  "rejectRequestPattern": ["/^.*\\.(css)"]
+}' \
+  --output "cloudflare.pdf"
+```
+
+## Parameters
+
+- `url` _(string)_ - The webpage URL to render as a PDF.
+- `addStyleTag` _(array of objects)_ - Injects custom CSS before generating the PDF.
+  - `content` _(string)_ - Inline CSS styles.
+  - `url` _(string)_ - URL of an external stylesheet.
+- `setExtraHTTPHeaders` _(object)_ - Adds custom HTTP headers when making the request.
+  - `X-Custom-Header` _(string)_ - Example of a custom header.
+- `viewport` _(object)_ - Defines the browser viewport size.
+  - `width` _(number)_ - Viewport width in pixels.
+  - `height` _(number)_ - Viewport height in pixels.
+- `gotoOptions` _(object)_ - Configures page navigation settings.
+  - `waitUntil` _(string)_ - Defines when the browser considers the page fully loaded.
+  - `timeout` _(number)_ - Maximum wait time before failing the request.
+- `rejectResourceTypes` _(array)_ - Blocks specific resource types to improve rendering performance.
+- `rejectRequestPattern` _(array of regex patterns)_ - Prevents loading of resources matching certain patterns.

src/content/docs/browser-rendering/quick-actions-rest-api/scrape-endpoint.mdx

@@ -0,0 +1,81 @@
+---
+pcx_content_type: how-to
+title: Scrape HTML elements
+sidebar:
+  order: 7
+---
+
+The `/scrape` endpoint extracts structured data from specific elements on a webpage, returning details such as element dimensions and inner HTML.
+
+## Basic usage
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/scrape' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+  "url": "https://example.com/",
+  "elements": [{
+    "selector": "h1"
+  },
+  {
+    "selector": "a"
+  }]
+}
+```
+
+### JSON response
+
+```json title="json response"
+{
+	"success": true,
+	"result": [
+		{
+			"results": [
+				{
+					"attributes": [],
+					"height": 39,
+					"html": "Example Domain",
+					"left": 100,
+					"text": "Example Domain",
+					"top": 133.4375,
+					"width": 600
+				}
+			],
+			"selector": "h1"
+		},
+		{
+			"results": [
+				{
+					"attributes": [
+						{ "name": "href", "value": "https://www.iana.org/domains/example" }
+					],
+					"height": 20,
+					"html": "More information...",
+					"left": 100,
+					"text": "More information...",
+					"top": 249.875,
+					"width": 142
+				}
+			],
+			"selector": "a"
+		}
+	]
+}
+```
+
+## Parameters
+
+- `url` _(string)_ - The webpage to extract data from.
+- `elements` _(object)_ - Defines the elements to extract from the page.
+  - `selectors` _(array of strings)_ - List of CSS selectors identifying elements to scrape (e.g., `"h1"`, `".article"`).
+
+### Response fields
+
+- `results` _(array of objects)_ - Contains extracted data for each selector.
+  - `selector` _(string)_ - The CSS selector used.
+  - `results` _(array of objects)_ - List of extracted elements matching the selector.
+    - `text` _(string)_ - Inner text of the element.
+    - `html` _(string)_ - Inner HTML of the element.
+    - `attributes` _(array of objects)_ - List of extracted attributes such as `href` for links.
+    - `height`, `width`, `top`, `left` _(number)_ - Position and dimensions of the element.

src/content/docs/browser-rendering/quick-actions-rest-api/screenshot-endpoint.mdx

@@ -0,0 +1,95 @@
+---
+pcx_content_type: how-to
+title: Capture screenshot
+sidebar:
+  order: 3
+---
+
+The `/screenshot` endpoint renders the webpage by processing its HTML and JavaScript, then captures a screenshot of the fully rendered page.
+
+## Basic usage
+
+Sets the HTML content of the page to `Hello World!` and then takes a screenshot. The option `omitBackground` hides the default white background and allows capturing screenshots with transparency.
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/screenshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "html": "Hello World!",
+    "screenshotOptions": {
+      "omitBackground": true
+    }
+  }' \
+  --output "screenshot.webp"
+```
+
+## Advanced usage
+
+Navigate to `https://cloudflare.com/`, changing the page size and waiting until there are no active network connections or up to a maximum of `4500ms`. Then take a `fullPage` screenshot.
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/screenshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://cloudflare.com/",
+    "screenshotOptions": {
+       "fullPage": true,
+      "omitBackground": true,
+    },
+    "viewport": {
+      "width": 1280,
+      "height": 720
+    },
+    "gotoOptions": {
+      "waitUntil": "networkidle0",
+      "timeout": 45000
+    }
+  }' \
+  --output "advanced-screenshot.webp"
+```
+
+## Customize CSS and embed custom JavaScript
+
+```bash
+curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-rendering/screenshot' \
+  -H 'Authorization: Bearer <apiToken>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "url": "https://example.com/",
+    "addScriptTag": [
+
+      { "content": "document.querySelector(`h1`).innerText = `Hello World!!!`" }
+    ],
+    "addStyleTag": [
+      {
+        "content": "div { background: linear-gradient(45deg, #2980b9  , #82e0aa  ); }"
+      },
+      {
+        "url": "https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css"
+      }
+    ]
+  }' \
+  --output "screenshot.webp"
+```
+
+## Parameters
+
+- `url` _(string)_ - The webpage URL to take a screenshot of.
+- `html` _(string)_ - Instead of a URL, allows rendering custom HTML for the screenshot.
+- `screenshotOptions` _(object)_ - Configures the screenshot format and quality.
+  - `omitBackground` _(boolean)_ - Removes the default white background when taking a screenshot.
+- `viewport` _(object)_ - Sets the browser viewport dimensions for rendering.
+  - `width` _(number)_ - Viewport width in pixels.
+  - `height` _(number)_ - Viewport height in pixels.
+- `gotoOptions` _(object)_ - Configures how and when the page is considered fully loaded.
+  - `waitUntil` _(string)_ - Defines when the browser considers navigation complete (`networkidle0`, `domcontentloaded`).
+    - `networkidle0` - Waits until there are no more than 0 network connections for at least 500 ms before taking a screenshot.
+  - `timeout` _(number)_ - Maximum wait time (in milliseconds) before navigation times out.
+- `addScriptTag` _(array of objects)_ - Injects JavaScript code before taking a screenshot.
+  - `url` _(string)_ - Loads an external script file before rendering.
+  - `content` _(string)_ - Runs inline JavaScript before rendering.
+- `addStyleTag` _(array of objects)_ - Injects CSS styles before rendering.
+  - `content` _(string)_ - Defines inline CSS rules.
+  - `url` _(string)_ - Loads external stylesheets before rendering.