Render HTML, Markdown, or URLs to images, PDF, or branded artifacts; extract and watch pages.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional: a static 'Bearer rdx_<key>' from the rendex.dev dashboard. Zero-config clients (Claude, ChatGPT) can instead use the built-in OAuth 2.1 (auth-code + PKCE) flow — no header needed.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the user asks to make or create a branded report, invoice, summary, release notes, or document — or to 'turn this Markdown/HTML into a PDF and PNG' (optionally with a logo or accent color). Do NOT use to screenshot an existing URL (use rendex_screenshot). Turns Markdown or HTML into a branded, downloadable artifact — a PDF, a PNG, and a hosted share page — in one call. Apply a logo, accentColor, font, header, and footer. Returns hosted URLs { pdfUrl, pngUrl, shareUrl, expiresAt }. Each requested format costs 1 render credit.
The Markdown or HTML body to render (up to ~4MB).
Optional Mustache data. When present, content is rendered as a logic-less Mustache template (plus the branding fields as {{logo}}/{{header}}/...) before conversion.
CSS font-family stack for the body (e.g. 'Georgia, serif').
Absolute http(s) URL of a logo image shown in the header.
Plain-text footer line shown at the bottom.
Plain-text header line shown beside the logo.
Which formats to produce. Each costs 1 credit. Default both.
Seconds until the hosted URLs expire (3600-2592000). Default 86400 (24h).
Optional paper/viewport setup.
CSS accent color for the bar, links, and headings (e.g. '#EA580C').
How to interpret content. 'markdown' is converted to styled HTML; 'html' is used as a body fragment.
Use this when the user asks to make or create a branded report, invoice, summary, release notes, or document — or to 'turn this Markdown/HTML into a PDF and PNG' (optionally with a logo or accent color). Do NOT use to screenshot an existing URL (use rendex_screenshot). Turns Markdown or HTML into a branded, downloadable artifact — a PDF, a PNG, and a hosted share page — in one call. Apply a logo, accentColor, font, header, and footer. Returns hosted URLs { pdfUrl, pngUrl, shareUrl, expiresAt }. Each requested format costs 1 render credit.
| Argument | Type | Description |
|---|---|---|
| data | object | Optional Mustache data. When present, content is rendered as a logic-less Mustache template (plus the branding fields as {{logo}}/{{header}}/...) before conversion. |
| font | string | CSS font-family stack for the body (e.g. 'Georgia, serif'). |
| logo | string | Absolute http(s) URL of a logo image shown in the header. |
| footer | string | Plain-text footer line shown at the bottom. |
| header | string | Plain-text header line shown beside the logo. |
| content* | string | The Markdown or HTML body to render (up to ~4MB). |
| formats | array | Which formats to produce. Each costs 1 credit. Default both. |
| expiresIn | integer | Seconds until the hosted URLs expire (3600-2592000). Default 86400 (24h). |
| pageSetup | object | Optional paper/viewport setup. |
| accentColor | string | CSS accent color for the bar, links, and headings (e.g. '#EA580C'). |
| inputFormat | string | How to interpret content. 'markdown' is converted to styled HTML; 'html' is used as a body fragment. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"content"
],
"properties": {
"data": {
"type": "object",
"description": "Optional Mustache data. When present, content is rendered as a logic-less Mustache template (plus the branding fields as {{logo}}/{{header}}/...) before conversion.",
"additionalProperties": {}
},
"font": {
"type": "string",
"maxLength": 120,
"description": "CSS font-family stack for the body (e.g. 'Georgia, serif')."
},
"logo": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Absolute http(s) URL of a logo image shown in the header."
},
"footer": {
"type": "string",
"maxLength": 2000,
"description": "Plain-text footer line shown at the bottom."
},
"header": {
"type": "string",
"maxLength": 2000,
"description": "Plain-text header line shown beside the logo."
},
"content": {
"type": "string",
"maxLength": 4000000,
"minLength": 1,
"description": "The Markdown or HTML body to render (up to ~4MB)."
},
"formats": {
"type": "array",
"items": {
"enum": [
"pdf",
"png"
],
"type": "string"
},
"default": [
"pdf",
"png"
],
"maxItems": 2,
"minItems": 1,
"description": "Which formats to produce. Each costs 1 credit. Default both."
},
"expiresIn": {
"type": "integer",
"maximum": 2592000,
"minimum": 3600,
"description": "Seconds until the hosted URLs expire (3600-2592000). Default 86400 (24h)."
},
"pageSetup": {
"type": "object",
"properties": {
"size": {
"enum": [
"A4",
"Letter",
"Legal",
"Tabloid",
"A3"
],
"type": "string",
"description": "PDF paper size. Default A4."
},
"scale": {
"type": "number",
"maximum": 2,
"minimum": 0.1,
"description": "PDF render scale (0.1-2). Default 1."
},
"width": {
"type": "integer",
"maximum": 3840,
"minimum": 320,
"description": "PNG viewport width in px. Default 1280."
},
"height": {
"type": "integer",
"maximum": 2160,
"minimum": 240,
"description": "PNG viewport height in px. Default 800."
},
"margin": {
"type": "object",
"properties": {
"top": {
"type": "string",
"maxLength": 16
},
"left": {
"type": "string",
"maxLength": 16
},
"right": {
"type": "string",
"maxLength": 16
},
"bottom": {
"type": "string",
"maxLength": 16
}
},
"description": "PDF margins as CSS values (e.g. '1cm').",
"additionalProperties": false
},
"fullPage": {
"type": "boolean",
"description": "Capture the full scrollable page for the PNG. Default true."
},
"orientation": {
"enum": [
"portrait",
"landscape"
],
"type": "string",
"description": "PDF orientation. Default portrait."
}
},
"description": "Optional paper/viewport setup.",
"additionalProperties": false
},
"accentColor": {
"type": "string",
"maxLength": 64,
"description": "CSS accent color for the bar, links, and headings (e.g. '#EA580C')."
},
"inputFormat": {
"enum": [
"markdown",
"html"
],
"type": "string",
"default": "markdown",
"description": "How to interpret content. 'markdown' is converted to styled HTML; 'html' is used as a body fragment."
}
},
"additionalProperties": false
}Check the Rendex account: which plan it's on, how many render credits have been used vs. the monthly limit (and when it resets), the per-minute rate limit, and a one-tap link to upgrade to a higher tier. Use this whenever the user asks about their usage, remaining quota, current plan, or how to get more renders / stop hitting limits. Read-only — costs no credits.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Use this when the user asks to read, extract, get the text/content/article of, or summarize a webpage/URL. Do NOT use for a visual screenshot (use rendex_screenshot). Extracts clean reader-mode content from any webpage as Markdown, JSON, or HTML. Runs the same Chromium render pass as a screenshot, so it captures content after JavaScript runs — handles SPAs that fetch-only readers miss. Strips nav, ads, and boilerplate, returning the article body plus title, byline, and excerpt. Great for feeding page content to an LLM, summarization, or RAG ingestion. Costs 1 render credit per call.
| Argument | Type | Description |
|---|---|---|
| url* | string | The webpage URL to extract readable content from (a schemeless host like 'example.com' is accepted). |
| device | string | Device preset that sets viewport, scale factor, and user agent in one shot. E.g. 'iphone_15' to extract the mobile version of a page. |
| timeout | integer | Maximum seconds to wait for page load (5-60). Cloudflare has a 60s hard cap. |
| blockAds | boolean | Block ads and trackers before extraction |
| waitUntil | string | Page readiness event. networkidle2 (default) is best for most sites. Use domcontentloaded for speed, networkidle0 for completeness. |
| extractFormat | string | Output shape — markdown (default, LLM-friendly prose), json (structured fields: title/byline/excerpt/siteName/length), or html (cleaned reader-mode HTML). |
Use this when the user wants a reusable, HOSTED image URL — an og:image or a link to embed in an <img> tag — rather than the image bytes. Do NOT use for a one-off inline screenshot (use rendex_screenshot). Renders a URL, raw HTML, or Markdown and gives back a signed, hosted, edge-cached image URL instead of the bytes — ideal for dynamic OG images: drop the URL into <meta property="og:image"> or an <img> tag and Rendex serves a cached copy on every share. Takes the same options as rendex_screenshot, plus an optional expiresIn. Returns { url, expiresAt, format, cacheTtl } as JSON. Costs 1 render credit per fresh render; cached repeat hits don't re-charge.
| Argument | Type | Description |
|---|---|---|
| js | string | Custom JavaScript to execute in the page before capture. Runs in the browser sandbox. Max 50KB. |
| css | string | Custom CSS to inject into the page before capture. Hide cookie banners, add watermarks, override styles. Max 50KB. |
| geo | string | ISO 3166-1 alpha-2 country code for geo-targeted capture (e.g., 'US', 'DE', 'JP'). Renders the page as seen from that country. Pro/Enterprise only. Note: CSS/JS injection, cookies, element capture, dark mode, and some other features are not available with geo-targeting. |
| url | string | The webpage URL to capture (a schemeless host like 'example.com' is accepted). Mutually exclusive with 'html' and 'markdown'. |
| data | object | Key-value data object for Mustache templating. When provided, the 'html' or 'markdown' string is rendered as a logic-less Mustache template before capture — {{var}} inserts HTML-escaped, {{{var}}} inserts raw, {{#items}}...{{/items}} iterates arrays, {{a.b}} accesses nested fields. Not valid with 'url'. Max 256KB serialized. |
Use this when the user asks to screenshot, capture, or take a picture of a webpage/URL, or to render raw HTML or Markdown to an image or PDF. Do NOT use to get a reusable hosted image URL (use rendex_render_link) or to make a branded multi-format document (use render_artifact). Captures a screenshot or PDF of any webpage, raw HTML, or Markdown. Supports full-page capture, dark mode, ad blocking, custom viewports, CSS/JS injection, cookie/header injection, PDF output, HTML and Markdown rendering, and progressive fallback for heavy sites. Returns partial renders on timeout by default (bestAttempt mode). Costs 1 render credit per call. Cookie/header injection requires Starter+; geo-targeting requires Pro+.
| Argument | Type | Description |
|---|---|---|
| js | string | Custom JavaScript to execute in the page before capture. Runs in the browser sandbox. Max 50KB. |
| css | string | Custom CSS to inject into the page before capture. Hide cookie banners, add watermarks, override styles. Max 50KB. |
| geo | string | ISO 3166-1 alpha-2 country code for geo-targeted capture (e.g., 'US', 'DE', 'JP'). Renders the page as seen from that country. Pro/Enterprise only. Note: CSS/JS injection, cookies, element capture, dark mode, and some other features are not available with geo-targeting. |
| url | string | The webpage URL to capture (a schemeless host like 'example.com' is accepted). Mutually exclusive with 'html' and 'markdown'. |
| data | object | Key-value data object for Mustache templating. When provided, the 'html' or 'markdown' string is rendered as a logic-less Mustache template before capture — {{var}} inserts HTML-escaped, {{{var}}} inserts raw, {{#items}}...{{/items}} iterates arrays, {{a.b}} accesses nested fields. Not valid with 'url'. Max 256KB serialized. |
Use this when the user asks to monitor, watch, or track a webpage for changes, or to be alerted/notified when a page changes. Do NOT use for a one-time capture (use rendex_screenshot). Creates a Rendex Watch — monitors a URL on a schedule and notifies when it changes (real-Chrome visual diff with a highlighted overlay, an extracted-text diff, or both). An active watch captures its baseline immediately. Returns the created watch as JSON.
| Argument | Type | Description |
|---|---|---|
| url* | string | The page to monitor (a schemeless host like 'rendex.dev/pricing' is upgraded to https). |
| name | string | Optional label for the watch. |
| paused | boolean | Create the watch paused (no baseline capture or charge until resumed). |
| diffMode | string | How changes are detected. Default 'both' = a pixel diff (with a highlighted overlay) AND a FULL-PAGE text diff, alerting on either — catches any change, visual or text. 'visual' or 'text' narrow to one signal only. |
| aiSummary | boolean | Pro+ — attach a one-sentence AI 'what changed' summary to each detected change. |
| threshold | number | Visual sensitivity (0..1). Low (default 0.01) alerts on ANY change, including a small one on a long page (a changed-region test, not a whole-page pixel ratio). 0.06+ = only MAJOR visual changes (whole-page ratio). Text detection is unaffected. |
| webhookUrl |
Delete a watch and its run history. Irreversible.
| Argument | Type | Description |
|---|---|---|
| id* | string | The watch ID (UUID). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The watch ID (UUID)."
}
},
"additionalProperties": false
}Fetch one watch by ID, including its current baseline image URL and status. Returns JSON.
| Argument | Type | Description |
|---|---|---|
| id* | string | The watch ID (UUID). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The watch ID (UUID)."
}
},
"additionalProperties": false
}List your watches (newest first), optionally filtered by status and paged. Returns { items, nextCursor }.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size (1–100). |
| cursor | string | Pagination cursor from a previous nextCursor. |
| status | string | Filter by status. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Page size (1–100)."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous nextCursor."
},
"status": {
"enum": [
"active",
"paused",
"all"
],
"type": "string",
"default": "all",
"description": "Filter by status."
}
},
"additionalProperties": false
}Run an immediate check now (charges 1 credit). Returns the queued run; poll watch_runs for the result or receive a watch.changed webhook.
| Argument | Type | Description |
|---|---|---|
| id* | string | The watch ID (UUID). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The watch ID (UUID)."
}
},
"additionalProperties": false
}Read a watch's run history (newest first), paged. Each run includes changed, diffScore, and signed before/after/overlay image URLs. Returns { items, nextCursor }.
| Argument | Type | Description |
|---|---|---|
| id* | string | The watch ID (UUID). |
| limit | integer | Page size (1–100). |
| cursor | string | Pagination cursor from a previous nextCursor. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The watch ID (UUID)."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Page size (1–100)."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous nextCursor."
}
},
"additionalProperties": false
}Dry-run a watch config BEFORE creating it — render the proposed config once and report what was captured + whether the page is reachable (and the text a text-watch would compare). Creates no watch, no baseline, no diff. Use this to validate a selector/scope/identity first. Returns JSON.
| Argument | Type | Description |
|---|---|---|
| url* | string | The page to monitor (a schemeless host like 'rendex.dev/pricing' is upgraded to https). |
| name | string | Optional label for the watch. |
| paused | boolean | Create the watch paused (no baseline capture or charge until resumed). |
| diffMode | string | How changes are detected. Default 'both' = a pixel diff (with a highlighted overlay) AND a FULL-PAGE text diff, alerting on either — catches any change, visual or text. 'visual' or 'text' narrow to one signal only. |
| aiSummary | boolean | Pro+ — attach a one-sentence AI 'what changed' summary to each detected change. |
| threshold | number | Visual sensitivity (0..1). Low (default 0.01) alerts on ANY change, including a small one on a long page (a changed-region test, not a whole-page pixel ratio). 0.06+ = only MAJOR visual changes (whole-page ratio). Text detection is unaffected. |
| webhookUrl |
Update a watch in place — pause/resume (paused), re-point (url), change schedule/diff/notify settings, or turn a channel off (webhookUrl/notifyEmail = null). Only the fields you send change; renderParams is deep-merged over the existing config. A scope change (url/selector/fullPage/size/device) re-baselines on the next check. Returns the updated watch as JSON.
| Argument | Type | Description |
|---|---|---|
| id* | string | The watch ID (UUID) to update. |
| url | string | Re-point to a new URL (clears the baseline; the next check re-baselines). |
| name | any | Rename the watch (null to clear). |
| paused | boolean | true to pause the watch, false to resume. |
| diffMode | string | Change what counts as a change. |
| aiSummary | boolean | Pro+ — toggle the one-sentence AI 'what changed' summary on each detected change. |
| threshold | number | Change the visual-change noise floor (0..1). |
| webhookUrl | any | Starter+ — set or replace the change-webhook target; null to turn it off. |
| notifyEmail |
| hideSelectors | array | CSS selectors to hide (display:none) before extraction. E.g. ['.modal', '#newsletter-popup'] to remove overlays. Max 50 selectors. |
| blockCookieBanners | boolean | Hide common cookie/consent walls (GDPR/CCPA banners) before extraction. A curated selector list, lighter than custom hideSelectors. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The webpage URL to extract readable content from (a schemeless host like 'example.com' is accepted)."
},
"device": {
"enum": [
"desktop",
"iphone_15",
"iphone_se",
"pixel_8",
"ipad",
"ipad_pro"
],
"type": "string",
"description": "Device preset that sets viewport, scale factor, and user agent in one shot. E.g. 'iphone_15' to extract the mobile version of a page."
},
"timeout": {
"type": "integer",
"default": 30,
"maximum": 60,
"minimum": 5,
"description": "Maximum seconds to wait for page load (5-60). Cloudflare has a 60s hard cap."
},
"blockAds": {
"type": "boolean",
"default": true,
"description": "Block ads and trackers before extraction"
},
"waitUntil": {
"enum": [
"load",
"domcontentloaded",
"networkidle0",
"networkidle2"
],
"type": "string",
"default": "networkidle2",
"description": "Page readiness event. networkidle2 (default) is best for most sites. Use domcontentloaded for speed, networkidle0 for completeness."
},
"extractFormat": {
"enum": [
"markdown",
"json",
"html"
],
"type": "string",
"default": "markdown",
"description": "Output shape — markdown (default, LLM-friendly prose), json (structured fields: title/byline/excerpt/siteName/length), or html (cleaned reader-mode HTML)."
},
"hideSelectors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "CSS selectors to hide (display:none) before extraction. E.g. ['.modal', '#newsletter-popup'] to remove overlays. Max 50 selectors."
},
"blockCookieBanners": {
"type": "boolean",
"description": "Hide common cookie/consent walls (GDPR/CCPA banners) before extraction. A curated selector list, lighter than custom hideSelectors."
}
},
"additionalProperties": false
}| html | string | Raw HTML to render and capture. Mutually exclusive with 'url' and 'markdown'. Great for invoices, social cards, email templates, OG images. |
| delay | integer | Milliseconds to wait after page load before capture (useful for JS-rendered content) |
| width | integer | Viewport width in pixels (320-3840) |
| device | string | Device preset that sets viewport, scale factor, and user agent in one shot. E.g. 'iphone_15' for a mobile screenshot. Overrides width/height/deviceScaleFactor/userAgent. |
| format | string | Output format — png (lossless), jpeg (smaller), webp (smallest), or pdf (document). Use pdf for invoices, reports, archival. |
| height | integer | Viewport height in pixels (240-2160) |
| cookies | array | Cookies to set before capture. Useful for authenticated pages. Max 50 cookies. |
| geoCity | string | City for more precise geo-targeting (e.g., 'Berlin', 'New York'). Requires 'geo'. |
| headers | object | Custom HTTP headers to send with the page request. Cannot override Host, Connection, Content-Length, or Transfer-Encoding. |
| quality | integer | Image quality 1-100 (JPEG/WebP only, ignored for PNG/PDF) |
| timeout | integer | Maximum seconds to wait for page load (5-60). Cloudflare has a 60s hard cap. |
| blockAds | boolean | Block ads and trackers before capture |
| darkMode | boolean | Emulate dark color scheme (prefers-color-scheme: dark) |
| fullPage | boolean | Capture the full scrollable page instead of just the viewport |
| geoState | string | State or region for more precise geo-targeting (e.g., 'California'). Requires 'geo'. |
| markdown | string | Markdown to render to an image or PDF. Mutually exclusive with 'url' and 'html'. The server converts it to HTML before rendering. Great for reports, release notes, README snapshots, documentation cards. |
| pdfScale | number | PDF scale factor (0.1-2). Default: 1 |
| selector | string | CSS selector of a specific element to capture instead of the full page. Useful for OG images, component extraction (e.g. '#hero', '.pricing-card') |
| expiresIn | integer | Seconds until the signed URL expires (60–2592000). Defaults to the server's TTL. |
| pdfFormat | string | PDF page size. Only used when format='pdf'. Default: A4 |
| pdfMargin | object | PDF page margins. Only used when format='pdf'. Accepts CSS values. |
| userAgent | string | Override the browser user agent string. |
| waitUntil | string | Page readiness event. networkidle2 (default) is best for most sites. Use domcontentloaded for speed, networkidle0 for completeness. |
| bestAttempt | boolean | If true (default), capture whatever is rendered on timeout instead of failing. Set to false to get a hard error on timeout. |
| resizeWidth | integer | Downscale the captured image to this width in pixels (16-3840). Aspect ratio is preserved if resizeHeight is omitted. Ignored for PDF. |
| pdfLandscape | boolean | PDF landscape orientation. Only used when format='pdf'. |
| resizeHeight | integer | Downscale the captured image to this height in pixels (16-2160). Aspect ratio is preserved if resizeWidth is omitted. Ignored for PDF. |
| hideSelectors | array | CSS selectors to hide (display:none) before capture. E.g. ['.modal', '#newsletter-popup'] to remove overlays. Max 50 selectors. |
| waitForSelector | string | CSS selector to wait for before capture. Essential for SPAs (e.g. '.main-content', '#app-loaded') |
| deviceScaleFactor | number | Device pixel ratio (1 = standard, 2 = retina). Defaults to 2× Retina. |
| blockCookieBanners | boolean | Hide common cookie/consent walls (GDPR/CCPA banners) before capture. A curated selector list, lighter than custom hideSelectors. |
| blockResourceTypes | array | Block specific resource types to speed up capture. E.g. ['font', 'image'] for text-only screenshots. |
| pdfPrintBackground | boolean | Print background colors/images in PDF. Default: true |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"js": {
"type": "string",
"maxLength": 51200,
"description": "Custom JavaScript to execute in the page before capture. Runs in the browser sandbox. Max 50KB."
},
"css": {
"type": "string",
"maxLength": 51200,
"description": "Custom CSS to inject into the page before capture. Hide cookie banners, add watermarks, override styles. Max 50KB."
},
"geo": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code for geo-targeted capture (e.g., 'US', 'DE', 'JP'). Renders the page as seen from that country. Pro/Enterprise only. Note: CSS/JS injection, cookies, element capture, dark mode, and some other features are not available with geo-targeting."
},
"url": {
"type": "string",
"format": "uri",
"description": "The webpage URL to capture (a schemeless host like 'example.com' is accepted). Mutually exclusive with 'html' and 'markdown'."
},
"data": {
"type": "object",
"description": "Key-value data object for Mustache templating. When provided, the 'html' or 'markdown' string is rendered as a logic-less Mustache template before capture — {{var}} inserts HTML-escaped, {{{var}}} inserts raw, {{#items}}...{{/items}} iterates arrays, {{a.b}} accesses nested fields. Not valid with 'url'. Max 256KB serialized.",
"additionalProperties": {}
},
"html": {
"type": "string",
"maxLength": 5242880,
"description": "Raw HTML to render and capture. Mutually exclusive with 'url' and 'markdown'. Great for invoices, social cards, email templates, OG images."
},
"delay": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "Milliseconds to wait after page load before capture (useful for JS-rendered content)"
},
"width": {
"type": "integer",
"default": 1280,
"maximum": 3840,
"minimum": 320,
"description": "Viewport width in pixels (320-3840)"
},
"device": {
"enum": [
"desktop",
"iphone_15",
"iphone_se",
"pixel_8",
"ipad",
"ipad_pro"
],
"type": "string",
"description": "Device preset that sets viewport, scale factor, and user agent in one shot. E.g. 'iphone_15' for a mobile screenshot. Overrides width/height/deviceScaleFactor/userAgent."
},
"format": {
"enum": [
"png",
"jpeg",
"webp",
"pdf"
],
"type": "string",
"default": "png",
"description": "Output format — png (lossless), jpeg (smaller), webp (smallest), or pdf (document). Use pdf for invoices, reports, archival."
},
"height": {
"type": "integer",
"default": 800,
"maximum": 2160,
"minimum": 240,
"description": "Viewport height in pixels (240-2160)"
},
"cookies": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"description": "Cookie name"
},
"path": {
"type": "string",
"description": "Cookie path"
},
"value": {
"type": "string",
"description": "Cookie value"
},
"domain": {
"type": "string",
"description": "Cookie domain (must match target URL domain)"
},
"secure": {
"type": "boolean",
"description": "Secure flag"
},
"expires": {
"type": "number",
"description": "Expiry as Unix timestamp"
},
"httpOnly": {
"type": "boolean",
"description": "HTTP-only flag"
},
"sameSite": {
"enum": [
"Strict",
"Lax",
"None"
],
"type": "string",
"description": "SameSite attribute"
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "Cookies to set before capture. Useful for authenticated pages. Max 50 cookies."
},
"geoCity": {
"type": "string",
"maxLength": 100,
"description": "City for more precise geo-targeting (e.g., 'Berlin', 'New York'). Requires 'geo'."
},
"headers": {
"type": "object",
"description": "Custom HTTP headers to send with the page request. Cannot override Host, Connection, Content-Length, or Transfer-Encoding.",
"additionalProperties": {
"type": "string"
}
},
"quality": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Image quality 1-100 (JPEG/WebP only, ignored for PNG/PDF)"
},
"timeout": {
"type": "integer",
"default": 30,
"maximum": 60,
"minimum": 5,
"description": "Maximum seconds to wait for page load (5-60). Cloudflare has a 60s hard cap."
},
"blockAds": {
"type": "boolean",
"default": true,
"description": "Block ads and trackers before capture"
},
"darkMode": {
"type": "boolean",
"default": false,
"description": "Emulate dark color scheme (prefers-color-scheme: dark)"
},
"fullPage": {
"type": "boolean",
"default": false,
"description": "Capture the full scrollable page instead of just the viewport"
},
"geoState": {
"type": "string",
"maxLength": 100,
"description": "State or region for more precise geo-targeting (e.g., 'California'). Requires 'geo'."
},
"markdown": {
"type": "string",
"maxLength": 5242880,
"description": "Markdown to render to an image or PDF. Mutually exclusive with 'url' and 'html'. The server converts it to HTML before rendering. Great for reports, release notes, README snapshots, documentation cards."
},
"pdfScale": {
"type": "number",
"maximum": 2,
"minimum": 0.1,
"description": "PDF scale factor (0.1-2). Default: 1"
},
"selector": {
"type": "string",
"maxLength": 500,
"description": "CSS selector of a specific element to capture instead of the full page. Useful for OG images, component extraction (e.g. '#hero', '.pricing-card')"
},
"expiresIn": {
"type": "integer",
"maximum": 2592000,
"minimum": 60,
"description": "Seconds until the signed URL expires (60–2592000). Defaults to the server's TTL."
},
"pdfFormat": {
"enum": [
"A4",
"Letter",
"Legal",
"Tabloid",
"A3"
],
"type": "string",
"description": "PDF page size. Only used when format='pdf'. Default: A4"
},
"pdfMargin": {
"type": "object",
"properties": {
"top": {
"type": "string",
"description": "Top margin (CSS value, e.g. '1cm', '20px')"
},
"left": {
"type": "string",
"description": "Left margin"
},
"right": {
"type": "string",
"description": "Right margin"
},
"bottom": {
"type": "string",
"description": "Bottom margin"
}
},
"description": "PDF page margins. Only used when format='pdf'. Accepts CSS values.",
"additionalProperties": false
},
"userAgent": {
"type": "string",
"maxLength": 512,
"description": "Override the browser user agent string."
},
"waitUntil": {
"enum": [
"load",
"domcontentloaded",
"networkidle0",
"networkidle2"
],
"type": "string",
"default": "networkidle2",
"description": "Page readiness event. networkidle2 (default) is best for most sites. Use domcontentloaded for speed, networkidle0 for completeness."
},
"bestAttempt": {
"type": "boolean",
"default": true,
"description": "If true (default), capture whatever is rendered on timeout instead of failing. Set to false to get a hard error on timeout."
},
"resizeWidth": {
"type": "integer",
"maximum": 3840,
"minimum": 16,
"description": "Downscale the captured image to this width in pixels (16-3840). Aspect ratio is preserved if resizeHeight is omitted. Ignored for PDF."
},
"pdfLandscape": {
"type": "boolean",
"description": "PDF landscape orientation. Only used when format='pdf'."
},
"resizeHeight": {
"type": "integer",
"maximum": 2160,
"minimum": 16,
"description": "Downscale the captured image to this height in pixels (16-2160). Aspect ratio is preserved if resizeWidth is omitted. Ignored for PDF."
},
"hideSelectors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "CSS selectors to hide (display:none) before capture. E.g. ['.modal', '#newsletter-popup'] to remove overlays. Max 50 selectors."
},
"waitForSelector": {
"type": "string",
"maxLength": 500,
"description": "CSS selector to wait for before capture. Essential for SPAs (e.g. '.main-content', '#app-loaded')"
},
"deviceScaleFactor": {
"type": "number",
"default": 2,
"maximum": 3,
"minimum": 1,
"description": "Device pixel ratio (1 = standard, 2 = retina). Defaults to 2× Retina."
},
"blockCookieBanners": {
"type": "boolean",
"description": "Hide common cookie/consent walls (GDPR/CCPA banners) before capture. A curated selector list, lighter than custom hideSelectors."
},
"blockResourceTypes": {
"type": "array",
"items": {
"enum": [
"font",
"image",
"media",
"stylesheet",
"other"
],
"type": "string"
},
"description": "Block specific resource types to speed up capture. E.g. ['font', 'image'] for text-only screenshots."
},
"pdfPrintBackground": {
"type": "boolean",
"description": "Print background colors/images in PDF. Default: true"
}
},
"additionalProperties": false
}| html | string | Raw HTML to render and capture. Mutually exclusive with 'url' and 'markdown'. Great for invoices, social cards, email templates, OG images. |
| delay | integer | Milliseconds to wait after page load before capture (useful for JS-rendered content) |
| width | integer | Viewport width in pixels (320-3840) |
| device | string | Device preset that sets viewport, scale factor, and user agent in one shot. E.g. 'iphone_15' for a mobile screenshot. Overrides width/height/deviceScaleFactor/userAgent. |
| format | string | Output format — png (lossless), jpeg (smaller), webp (smallest), or pdf (document). Use pdf for invoices, reports, archival. |
| height | integer | Viewport height in pixels (240-2160) |
| cookies | array | Cookies to set before capture. Useful for authenticated pages. Max 50 cookies. |
| geoCity | string | City for more precise geo-targeting (e.g., 'Berlin', 'New York'). Requires 'geo'. |
| headers | object | Custom HTTP headers to send with the page request. Cannot override Host, Connection, Content-Length, or Transfer-Encoding. |
| quality | integer | Image quality 1-100 (JPEG/WebP only, ignored for PNG/PDF) |
| timeout | integer | Maximum seconds to wait for page load (5-60). Cloudflare has a 60s hard cap. |
| blockAds | boolean | Block ads and trackers before capture |
| darkMode | boolean | Emulate dark color scheme (prefers-color-scheme: dark) |
| fullPage | boolean | Capture the full scrollable page instead of just the viewport |
| geoState | string | State or region for more precise geo-targeting (e.g., 'California'). Requires 'geo'. |
| markdown | string | Markdown to render to an image or PDF. Mutually exclusive with 'url' and 'html'. The server converts it to HTML before rendering. Great for reports, release notes, README snapshots, documentation cards. |
| pdfScale | number | PDF scale factor (0.1-2). Default: 1 |
| selector | string | CSS selector of a specific element to capture instead of the full page. Useful for OG images, component extraction (e.g. '#hero', '.pricing-card') |
| pdfFormat | string | PDF page size. Only used when format='pdf'. Default: A4 |
| pdfMargin | object | PDF page margins. Only used when format='pdf'. Accepts CSS values. |
| userAgent | string | Override the browser user agent string. |
| waitUntil | string | Page readiness event. networkidle2 (default) is best for most sites. Use domcontentloaded for speed, networkidle0 for completeness. |
| bestAttempt | boolean | If true (default), capture whatever is rendered on timeout instead of failing. Set to false to get a hard error on timeout. |
| resizeWidth | integer | Downscale the captured image to this width in pixels (16-3840). Aspect ratio is preserved if resizeHeight is omitted. Ignored for PDF. |
| pdfLandscape | boolean | PDF landscape orientation. Only used when format='pdf'. |
| resizeHeight | integer | Downscale the captured image to this height in pixels (16-2160). Aspect ratio is preserved if resizeWidth is omitted. Ignored for PDF. |
| hideSelectors | array | CSS selectors to hide (display:none) before capture. E.g. ['.modal', '#newsletter-popup'] to remove overlays. Max 50 selectors. |
| waitForSelector | string | CSS selector to wait for before capture. Essential for SPAs (e.g. '.main-content', '#app-loaded') |
| deviceScaleFactor | number | Device pixel ratio (1 = standard, 2 = retina). Defaults to 2× Retina. |
| blockCookieBanners | boolean | Hide common cookie/consent walls (GDPR/CCPA banners) before capture. A curated selector list, lighter than custom hideSelectors. |
| blockResourceTypes | array | Block specific resource types to speed up capture. E.g. ['font', 'image'] for text-only screenshots. |
| pdfPrintBackground | boolean | Print background colors/images in PDF. Default: true |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"js": {
"type": "string",
"maxLength": 51200,
"description": "Custom JavaScript to execute in the page before capture. Runs in the browser sandbox. Max 50KB."
},
"css": {
"type": "string",
"maxLength": 51200,
"description": "Custom CSS to inject into the page before capture. Hide cookie banners, add watermarks, override styles. Max 50KB."
},
"geo": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code for geo-targeted capture (e.g., 'US', 'DE', 'JP'). Renders the page as seen from that country. Pro/Enterprise only. Note: CSS/JS injection, cookies, element capture, dark mode, and some other features are not available with geo-targeting."
},
"url": {
"type": "string",
"format": "uri",
"description": "The webpage URL to capture (a schemeless host like 'example.com' is accepted). Mutually exclusive with 'html' and 'markdown'."
},
"data": {
"type": "object",
"description": "Key-value data object for Mustache templating. When provided, the 'html' or 'markdown' string is rendered as a logic-less Mustache template before capture — {{var}} inserts HTML-escaped, {{{var}}} inserts raw, {{#items}}...{{/items}} iterates arrays, {{a.b}} accesses nested fields. Not valid with 'url'. Max 256KB serialized.",
"additionalProperties": {}
},
"html": {
"type": "string",
"maxLength": 5242880,
"description": "Raw HTML to render and capture. Mutually exclusive with 'url' and 'markdown'. Great for invoices, social cards, email templates, OG images."
},
"delay": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "Milliseconds to wait after page load before capture (useful for JS-rendered content)"
},
"width": {
"type": "integer",
"default": 1280,
"maximum": 3840,
"minimum": 320,
"description": "Viewport width in pixels (320-3840)"
},
"device": {
"enum": [
"desktop",
"iphone_15",
"iphone_se",
"pixel_8",
"ipad",
"ipad_pro"
],
"type": "string",
"description": "Device preset that sets viewport, scale factor, and user agent in one shot. E.g. 'iphone_15' for a mobile screenshot. Overrides width/height/deviceScaleFactor/userAgent."
},
"format": {
"enum": [
"png",
"jpeg",
"webp",
"pdf"
],
"type": "string",
"default": "png",
"description": "Output format — png (lossless), jpeg (smaller), webp (smallest), or pdf (document). Use pdf for invoices, reports, archival."
},
"height": {
"type": "integer",
"default": 800,
"maximum": 2160,
"minimum": 240,
"description": "Viewport height in pixels (240-2160)"
},
"cookies": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"description": "Cookie name"
},
"path": {
"type": "string",
"description": "Cookie path"
},
"value": {
"type": "string",
"description": "Cookie value"
},
"domain": {
"type": "string",
"description": "Cookie domain (must match target URL domain)"
},
"secure": {
"type": "boolean",
"description": "Secure flag"
},
"expires": {
"type": "number",
"description": "Expiry as Unix timestamp"
},
"httpOnly": {
"type": "boolean",
"description": "HTTP-only flag"
},
"sameSite": {
"enum": [
"Strict",
"Lax",
"None"
],
"type": "string",
"description": "SameSite attribute"
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "Cookies to set before capture. Useful for authenticated pages. Max 50 cookies."
},
"geoCity": {
"type": "string",
"maxLength": 100,
"description": "City for more precise geo-targeting (e.g., 'Berlin', 'New York'). Requires 'geo'."
},
"headers": {
"type": "object",
"description": "Custom HTTP headers to send with the page request. Cannot override Host, Connection, Content-Length, or Transfer-Encoding.",
"additionalProperties": {
"type": "string"
}
},
"quality": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Image quality 1-100 (JPEG/WebP only, ignored for PNG/PDF)"
},
"timeout": {
"type": "integer",
"default": 30,
"maximum": 60,
"minimum": 5,
"description": "Maximum seconds to wait for page load (5-60). Cloudflare has a 60s hard cap."
},
"blockAds": {
"type": "boolean",
"default": true,
"description": "Block ads and trackers before capture"
},
"darkMode": {
"type": "boolean",
"default": false,
"description": "Emulate dark color scheme (prefers-color-scheme: dark)"
},
"fullPage": {
"type": "boolean",
"default": false,
"description": "Capture the full scrollable page instead of just the viewport"
},
"geoState": {
"type": "string",
"maxLength": 100,
"description": "State or region for more precise geo-targeting (e.g., 'California'). Requires 'geo'."
},
"markdown": {
"type": "string",
"maxLength": 5242880,
"description": "Markdown to render to an image or PDF. Mutually exclusive with 'url' and 'html'. The server converts it to HTML before rendering. Great for reports, release notes, README snapshots, documentation cards."
},
"pdfScale": {
"type": "number",
"maximum": 2,
"minimum": 0.1,
"description": "PDF scale factor (0.1-2). Default: 1"
},
"selector": {
"type": "string",
"maxLength": 500,
"description": "CSS selector of a specific element to capture instead of the full page. Useful for OG images, component extraction (e.g. '#hero', '.pricing-card')"
},
"pdfFormat": {
"enum": [
"A4",
"Letter",
"Legal",
"Tabloid",
"A3"
],
"type": "string",
"description": "PDF page size. Only used when format='pdf'. Default: A4"
},
"pdfMargin": {
"type": "object",
"properties": {
"top": {
"type": "string",
"description": "Top margin (CSS value, e.g. '1cm', '20px')"
},
"left": {
"type": "string",
"description": "Left margin"
},
"right": {
"type": "string",
"description": "Right margin"
},
"bottom": {
"type": "string",
"description": "Bottom margin"
}
},
"description": "PDF page margins. Only used when format='pdf'. Accepts CSS values.",
"additionalProperties": false
},
"userAgent": {
"type": "string",
"maxLength": 512,
"description": "Override the browser user agent string."
},
"waitUntil": {
"enum": [
"load",
"domcontentloaded",
"networkidle0",
"networkidle2"
],
"type": "string",
"default": "networkidle2",
"description": "Page readiness event. networkidle2 (default) is best for most sites. Use domcontentloaded for speed, networkidle0 for completeness."
},
"bestAttempt": {
"type": "boolean",
"default": true,
"description": "If true (default), capture whatever is rendered on timeout instead of failing. Set to false to get a hard error on timeout."
},
"resizeWidth": {
"type": "integer",
"maximum": 3840,
"minimum": 16,
"description": "Downscale the captured image to this width in pixels (16-3840). Aspect ratio is preserved if resizeHeight is omitted. Ignored for PDF."
},
"pdfLandscape": {
"type": "boolean",
"description": "PDF landscape orientation. Only used when format='pdf'."
},
"resizeHeight": {
"type": "integer",
"maximum": 2160,
"minimum": 16,
"description": "Downscale the captured image to this height in pixels (16-2160). Aspect ratio is preserved if resizeWidth is omitted. Ignored for PDF."
},
"hideSelectors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "CSS selectors to hide (display:none) before capture. E.g. ['.modal', '#newsletter-popup'] to remove overlays. Max 50 selectors."
},
"waitForSelector": {
"type": "string",
"maxLength": 500,
"description": "CSS selector to wait for before capture. Essential for SPAs (e.g. '.main-content', '#app-loaded')"
},
"deviceScaleFactor": {
"type": "number",
"default": 2,
"maximum": 3,
"minimum": 1,
"description": "Device pixel ratio (1 = standard, 2 = retina). Defaults to 2× Retina."
},
"blockCookieBanners": {
"type": "boolean",
"description": "Hide common cookie/consent walls (GDPR/CCPA banners) before capture. A curated selector list, lighter than custom hideSelectors."
},
"blockResourceTypes": {
"type": "array",
"items": {
"enum": [
"font",
"image",
"media",
"stylesheet",
"other"
],
"type": "string"
},
"description": "Block specific resource types to speed up capture. E.g. ['font', 'image'] for text-only screenshots."
},
"pdfPrintBackground": {
"type": "boolean",
"description": "Print background colors/images in PDF. Default: true"
}
},
"additionalProperties": false
}| string |
| Starter+ — HMAC-signed change-webhook target. |
| notifyEmail | string | Any plan — send change alerts here. Must be your OWN account email (others are rejected). Defaults to it if omitted. |
| renderParams | object | Render knobs applied on every check (a subset of the screenshot capture params). |
| intervalMinutes | integer | Check frequency in minutes. Minimum is your plan's floor — Free 1440 (daily), Basic 180, Starter 60, Pro 30, Enterprise 5. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The page to monitor (a schemeless host like 'rendex.dev/pricing' is upgraded to https)."
},
"name": {
"type": "string",
"maxLength": 120,
"description": "Optional label for the watch."
},
"paused": {
"type": "boolean",
"default": false,
"description": "Create the watch paused (no baseline capture or charge until resumed)."
},
"diffMode": {
"enum": [
"visual",
"text",
"both"
],
"type": "string",
"default": "both",
"description": "How changes are detected. Default 'both' = a pixel diff (with a highlighted overlay) AND a FULL-PAGE text diff, alerting on either — catches any change, visual or text. 'visual' or 'text' narrow to one signal only."
},
"aiSummary": {
"type": "boolean",
"default": false,
"description": "Pro+ — attach a one-sentence AI 'what changed' summary to each detected change."
},
"threshold": {
"type": "number",
"default": 0.01,
"maximum": 1,
"minimum": 0,
"description": "Visual sensitivity (0..1). Low (default 0.01) alerts on ANY change, including a small one on a long page (a changed-region test, not a whole-page pixel ratio). 0.06+ = only MAJOR visual changes (whole-page ratio). Text detection is unaffected."
},
"webhookUrl": {
"type": "string",
"format": "uri",
"description": "Starter+ — HMAC-signed change-webhook target."
},
"notifyEmail": {
"type": "string",
"format": "email",
"description": "Any plan — send change alerts here. Must be your OWN account email (others are rejected). Defaults to it if omitted."
},
"renderParams": {
"type": "object",
"properties": {
"geo": {
"type": "string",
"description": "Pro+ — ISO country code to render from. VISUAL-ONLY: cannot combine with a 'text' OR 'both' diffMode (a geo render returns no extracted text)."
},
"delay": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Delay in ms before capture (0–10000)."
},
"width": {
"type": "integer",
"maximum": 3840,
"minimum": 320,
"description": "Viewport width in px (320–3840)."
},
"device": {
"enum": [
"desktop",
"iphone_15",
"iphone_se",
"pixel_8",
"ipad",
"ipad_pro"
],
"type": "string",
"description": "Device preset (viewport + scale + UA). E.g. 'iphone_15' to monitor the mobile layout."
},
"format": {
"enum": [
"png",
"jpeg",
"webp",
"pdf"
],
"type": "string",
"description": "Capture format. A pdf cannot be visually diffed — pair it with diffMode 'text'. Default png."
},
"height": {
"type": "integer",
"maximum": 2160,
"minimum": 240,
"description": "Viewport height in px (240–2160)."
},
"uaMode": {
"enum": [
"auto",
"identify",
"stealth"
],
"type": "string",
"description": "User-Agent identity: auto (identify then fall back), identify (always RendexWatch), stealth (always a standard browser). See https://rendex.dev/bot"
},
"geoCity": {
"type": "string",
"description": "City for more precise geo-targeting (requires geo)."
},
"timeout": {
"type": "integer",
"maximum": 60,
"minimum": 5,
"description": "Page-load timeout in seconds (5–60)."
},
"blockAds": {
"type": "boolean",
"description": "Block ads/trackers before capture (default true)."
},
"darkMode": {
"type": "boolean",
"description": "Emulate prefers-color-scheme: dark."
},
"fullPage": {
"type": "boolean",
"default": true,
"description": "Monitor the whole scrollable page (default true for watches). Set false to watch only the viewport."
},
"geoState": {
"type": "string",
"description": "State/region for geo-targeting (requires geo)."
},
"selector": {
"type": "string",
"maxLength": 500,
"description": "Capture and diff ONLY this CSS element — watch one price/banner/section instead of the whole page."
},
"waitUntil": {
"enum": [
"load",
"domcontentloaded",
"networkidle0",
"networkidle2"
],
"type": "string",
"description": "Navigation readiness event."
},
"ignoreText": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 50,
"description": "Substrings or /regex/flags stripped from both texts before the text diff — silence timestamps, counters, tokens."
},
"minTextChars": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Minimum added + removed characters for a text change to count (ignore tiny edits)."
},
"hideSelectors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "CSS selectors to hide before capture (max 50)."
},
"ignoreRegions": {
"type": "array",
"items": {
"type": "object",
"required": [
"x",
"y",
"width",
"height"
],
"properties": {
"x": {
"type": "number",
"minimum": 0
},
"y": {
"type": "number",
"minimum": 0
},
"width": {
"type": "number",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Pixel rectangles masked in both captures before the visual diff — silence dynamic zones (ad slot, clock). Visual mode only."
},
"deviceScaleFactor": {
"type": "number",
"maximum": 3,
"minimum": 1,
"description": "Device pixel ratio (1–3)."
},
"blockCookieBanners": {
"type": "boolean",
"description": "Hide common cookie/consent banners before capture."
},
"suppressWhilePresent": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20,
"description": "While the page text contains any of these markers (e.g. 'Out of stock'), treat the run as unchanged."
}
},
"description": "Render knobs applied on every check (a subset of the screenshot capture params).",
"additionalProperties": false
},
"intervalMinutes": {
"type": "integer",
"default": 1440,
"maximum": 43200,
"minimum": 5,
"description": "Check frequency in minutes. Minimum is your plan's floor — Free 1440 (daily), Basic 180, Starter 60, Pro 30, Enterprise 5."
}
},
"additionalProperties": false
}| string |
| Starter+ — HMAC-signed change-webhook target. |
| notifyEmail | string | Any plan — send change alerts here. Must be your OWN account email (others are rejected). Defaults to it if omitted. |
| renderParams | object | Render knobs applied on every check (a subset of the screenshot capture params). |
| intervalMinutes | integer | Check frequency in minutes. Minimum is your plan's floor — Free 1440 (daily), Basic 180, Starter 60, Pro 30, Enterprise 5. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The page to monitor (a schemeless host like 'rendex.dev/pricing' is upgraded to https)."
},
"name": {
"type": "string",
"maxLength": 120,
"description": "Optional label for the watch."
},
"paused": {
"type": "boolean",
"default": false,
"description": "Create the watch paused (no baseline capture or charge until resumed)."
},
"diffMode": {
"enum": [
"visual",
"text",
"both"
],
"type": "string",
"default": "both",
"description": "How changes are detected. Default 'both' = a pixel diff (with a highlighted overlay) AND a FULL-PAGE text diff, alerting on either — catches any change, visual or text. 'visual' or 'text' narrow to one signal only."
},
"aiSummary": {
"type": "boolean",
"default": false,
"description": "Pro+ — attach a one-sentence AI 'what changed' summary to each detected change."
},
"threshold": {
"type": "number",
"default": 0.01,
"maximum": 1,
"minimum": 0,
"description": "Visual sensitivity (0..1). Low (default 0.01) alerts on ANY change, including a small one on a long page (a changed-region test, not a whole-page pixel ratio). 0.06+ = only MAJOR visual changes (whole-page ratio). Text detection is unaffected."
},
"webhookUrl": {
"type": "string",
"format": "uri",
"description": "Starter+ — HMAC-signed change-webhook target."
},
"notifyEmail": {
"type": "string",
"format": "email",
"description": "Any plan — send change alerts here. Must be your OWN account email (others are rejected). Defaults to it if omitted."
},
"renderParams": {
"type": "object",
"properties": {
"geo": {
"type": "string",
"description": "Pro+ — ISO country code to render from. VISUAL-ONLY: cannot combine with a 'text' OR 'both' diffMode (a geo render returns no extracted text)."
},
"delay": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Delay in ms before capture (0–10000)."
},
"width": {
"type": "integer",
"maximum": 3840,
"minimum": 320,
"description": "Viewport width in px (320–3840)."
},
"device": {
"enum": [
"desktop",
"iphone_15",
"iphone_se",
"pixel_8",
"ipad",
"ipad_pro"
],
"type": "string",
"description": "Device preset (viewport + scale + UA). E.g. 'iphone_15' to monitor the mobile layout."
},
"format": {
"enum": [
"png",
"jpeg",
"webp",
"pdf"
],
"type": "string",
"description": "Capture format. A pdf cannot be visually diffed — pair it with diffMode 'text'. Default png."
},
"height": {
"type": "integer",
"maximum": 2160,
"minimum": 240,
"description": "Viewport height in px (240–2160)."
},
"uaMode": {
"enum": [
"auto",
"identify",
"stealth"
],
"type": "string",
"description": "User-Agent identity: auto (identify then fall back), identify (always RendexWatch), stealth (always a standard browser). See https://rendex.dev/bot"
},
"geoCity": {
"type": "string",
"description": "City for more precise geo-targeting (requires geo)."
},
"timeout": {
"type": "integer",
"maximum": 60,
"minimum": 5,
"description": "Page-load timeout in seconds (5–60)."
},
"blockAds": {
"type": "boolean",
"description": "Block ads/trackers before capture (default true)."
},
"darkMode": {
"type": "boolean",
"description": "Emulate prefers-color-scheme: dark."
},
"fullPage": {
"type": "boolean",
"default": true,
"description": "Monitor the whole scrollable page (default true for watches). Set false to watch only the viewport."
},
"geoState": {
"type": "string",
"description": "State/region for geo-targeting (requires geo)."
},
"selector": {
"type": "string",
"maxLength": 500,
"description": "Capture and diff ONLY this CSS element — watch one price/banner/section instead of the whole page."
},
"waitUntil": {
"enum": [
"load",
"domcontentloaded",
"networkidle0",
"networkidle2"
],
"type": "string",
"description": "Navigation readiness event."
},
"ignoreText": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 50,
"description": "Substrings or /regex/flags stripped from both texts before the text diff — silence timestamps, counters, tokens."
},
"minTextChars": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Minimum added + removed characters for a text change to count (ignore tiny edits)."
},
"hideSelectors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "CSS selectors to hide before capture (max 50)."
},
"ignoreRegions": {
"type": "array",
"items": {
"type": "object",
"required": [
"x",
"y",
"width",
"height"
],
"properties": {
"x": {
"type": "number",
"minimum": 0
},
"y": {
"type": "number",
"minimum": 0
},
"width": {
"type": "number",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Pixel rectangles masked in both captures before the visual diff — silence dynamic zones (ad slot, clock). Visual mode only."
},
"deviceScaleFactor": {
"type": "number",
"maximum": 3,
"minimum": 1,
"description": "Device pixel ratio (1–3)."
},
"blockCookieBanners": {
"type": "boolean",
"description": "Hide common cookie/consent banners before capture."
},
"suppressWhilePresent": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20,
"description": "While the page text contains any of these markers (e.g. 'Out of stock'), treat the run as unchanged."
}
},
"description": "Render knobs applied on every check (a subset of the screenshot capture params).",
"additionalProperties": false
},
"intervalMinutes": {
"type": "integer",
"default": 1440,
"maximum": 43200,
"minimum": 5,
"description": "Check frequency in minutes. Minimum is your plan's floor — Free 1440 (daily), Basic 180, Starter 60, Pro 30, Enterprise 5."
}
},
"additionalProperties": false
}| any |
| Set the alert email (your account email only); null to turn it off. |
| renderParams | object | Render knobs to deep-merge over the existing capture config. |
| intervalMinutes | integer | New check frequency in minutes (subject to your plan's floor). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The watch ID (UUID) to update."
},
"url": {
"type": "string",
"format": "uri",
"description": "Re-point to a new URL (clears the baseline; the next check re-baselines)."
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
],
"description": "Rename the watch (null to clear)."
},
"paused": {
"type": "boolean",
"description": "true to pause the watch, false to resume."
},
"diffMode": {
"enum": [
"visual",
"text",
"both"
],
"type": "string",
"description": "Change what counts as a change."
},
"aiSummary": {
"type": "boolean",
"description": "Pro+ — toggle the one-sentence AI 'what changed' summary on each detected change."
},
"threshold": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Change the visual-change noise floor (0..1)."
},
"webhookUrl": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "Starter+ — set or replace the change-webhook target; null to turn it off."
},
"notifyEmail": {
"anyOf": [
{
"type": "string",
"format": "email"
},
{
"type": "null"
}
],
"description": "Set the alert email (your account email only); null to turn it off."
},
"renderParams": {
"type": "object",
"properties": {
"geo": {
"type": "string",
"description": "Pro+ — ISO country code to render from. VISUAL-ONLY: cannot combine with a 'text' OR 'both' diffMode (a geo render returns no extracted text)."
},
"delay": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Delay in ms before capture (0–10000)."
},
"width": {
"type": "integer",
"maximum": 3840,
"minimum": 320,
"description": "Viewport width in px (320–3840)."
},
"device": {
"enum": [
"desktop",
"iphone_15",
"iphone_se",
"pixel_8",
"ipad",
"ipad_pro"
],
"type": "string",
"description": "Device preset (viewport + scale + UA). E.g. 'iphone_15' to monitor the mobile layout."
},
"format": {
"enum": [
"png",
"jpeg",
"webp",
"pdf"
],
"type": "string",
"description": "Capture format. A pdf cannot be visually diffed — pair it with diffMode 'text'. Default png."
},
"height": {
"type": "integer",
"maximum": 2160,
"minimum": 240,
"description": "Viewport height in px (240–2160)."
},
"uaMode": {
"enum": [
"auto",
"identify",
"stealth"
],
"type": "string",
"description": "User-Agent identity: auto (identify then fall back), identify (always RendexWatch), stealth (always a standard browser). See https://rendex.dev/bot"
},
"geoCity": {
"type": "string",
"description": "City for more precise geo-targeting (requires geo)."
},
"timeout": {
"type": "integer",
"maximum": 60,
"minimum": 5,
"description": "Page-load timeout in seconds (5–60)."
},
"blockAds": {
"type": "boolean",
"description": "Block ads/trackers before capture (default true)."
},
"darkMode": {
"type": "boolean",
"description": "Emulate prefers-color-scheme: dark."
},
"fullPage": {
"type": "boolean",
"default": true,
"description": "Monitor the whole scrollable page (default true for watches). Set false to watch only the viewport."
},
"geoState": {
"type": "string",
"description": "State/region for geo-targeting (requires geo)."
},
"selector": {
"type": "string",
"maxLength": 500,
"description": "Capture and diff ONLY this CSS element — watch one price/banner/section instead of the whole page."
},
"waitUntil": {
"enum": [
"load",
"domcontentloaded",
"networkidle0",
"networkidle2"
],
"type": "string",
"description": "Navigation readiness event."
},
"ignoreText": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 50,
"description": "Substrings or /regex/flags stripped from both texts before the text diff — silence timestamps, counters, tokens."
},
"minTextChars": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Minimum added + removed characters for a text change to count (ignore tiny edits)."
},
"hideSelectors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "CSS selectors to hide before capture (max 50)."
},
"ignoreRegions": {
"type": "array",
"items": {
"type": "object",
"required": [
"x",
"y",
"width",
"height"
],
"properties": {
"x": {
"type": "number",
"minimum": 0
},
"y": {
"type": "number",
"minimum": 0
},
"width": {
"type": "number",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Pixel rectangles masked in both captures before the visual diff — silence dynamic zones (ad slot, clock). Visual mode only."
},
"deviceScaleFactor": {
"type": "number",
"maximum": 3,
"minimum": 1,
"description": "Device pixel ratio (1–3)."
},
"blockCookieBanners": {
"type": "boolean",
"description": "Hide common cookie/consent banners before capture."
},
"suppressWhilePresent": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20,
"description": "While the page text contains any of these markers (e.g. 'Out of stock'), treat the run as unchanged."
}
},
"description": "Render knobs to deep-merge over the existing capture config.",
"additionalProperties": false
},
"intervalMinutes": {
"type": "integer",
"maximum": 43200,
"minimum": 5,
"description": "New check frequency in minutes (subject to your plan's floor)."
}
},
"additionalProperties": false
}