{ "openapi": "3.0.3", "info": { "title": "PDF & Screenshot - HTML/URL to PDF, PNG, JPEG", "version": "1.0.0", "description": "Render any web page or your own HTML into a PDF or an image with a real Chromium browser. PDF: A3/A4/A5/Letter/Legal, landscape, margins, background graphics, header and footer templates with page numbers, page ranges. Screenshot: PNG/JPEG/WebP, viewport size, retina (scale_factor up to 3), full page, single element by CSS selector, transparent background, dark mode. Extras: wait for a selector, delay, hide cookie banners with CSS selectors, inject CSS. Returns the file directly or JSON with a base64 data URI." }, "servers": [ { "url": "https://rasareka-pdf-screenshot.fauzyamy.workers.dev" } ], "paths": { "/v1/screenshot": { "get": { "summary": "Screenshot a URL", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "example": "https://example.com" }, { "name": "format", "in": "query", "required": false, "description": "png, jpeg or webp", "schema": { "type": "string", "enum": [ "png", "jpeg", "webp" ] } }, { "name": "width", "in": "query", "required": false, "description": "Viewport width 320-3840", "schema": { "type": "integer" }, "example": 1280 }, { "name": "height", "in": "query", "required": false, "description": "Viewport height 200-2160", "schema": { "type": "integer" }, "example": 800 }, { "name": "full_page", "in": "query", "required": false, "description": "Capture the whole page", "schema": { "type": "boolean" } }, { "name": "selector", "in": "query", "required": false, "description": "Capture only this element", "schema": { "type": "string" } }, { "name": "scale_factor", "in": "query", "required": false, "description": "1-3 (retina)", "schema": { "type": "number" } }, { "name": "quality", "in": "query", "required": false, "description": "JPEG/WebP 1-100", "schema": { "type": "integer" } }, { "name": "delay", "in": "query", "required": false, "description": "ms to wait after load (max 10000)", "schema": { "type": "integer" } }, { "name": "wait_for_selector", "in": "query", "required": false, "description": "Wait until this element exists", "schema": { "type": "string" } }, { "name": "hide_selectors", "in": "query", "required": false, "description": "CSS selectors to hide, e.g. cookie banners", "schema": { "type": "string" } }, { "name": "dark_mode", "in": "query", "required": false, "description": "Emulate prefers-color-scheme: dark", "schema": { "type": "boolean" } }, { "name": "transparent", "in": "query", "required": false, "description": "Transparent background (PNG/WebP)", "schema": { "type": "boolean" } }, { "name": "response", "in": "query", "required": false, "description": "json = base64 data URI", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Image", "content": { "image/png": {}, "image/jpeg": {}, "image/webp": {} } } } }, "post": { "summary": "Screenshot your HTML (or a URL)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "html": "

Hello

", "width": 800, "height": 400, "format": "png" } } } }, "responses": { "200": { "description": "Image" } } } }, "/v1/pdf": { "get": { "summary": "Render a URL to PDF", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "example": "https://example.com" }, { "name": "paper", "in": "query", "required": false, "description": "A3, A4, A5, Letter, Legal, Tabloid", "schema": { "type": "string", "enum": [ "A3", "A4", "A5", "Letter", "Legal", "Tabloid" ] } }, { "name": "landscape", "in": "query", "required": false, "description": "Landscape orientation", "schema": { "type": "boolean" } }, { "name": "margin", "in": "query", "required": false, "description": "e.g. 10mm, 1cm, 0.5in", "schema": { "type": "string" } }, { "name": "print_background", "in": "query", "required": false, "description": "Include background graphics (default true)", "schema": { "type": "boolean" } }, { "name": "scale", "in": "query", "required": false, "description": "0.1-2", "schema": { "type": "number" } }, { "name": "page_ranges", "in": "query", "required": false, "description": "e.g. 1-3", "schema": { "type": "string" } }, { "name": "hide_selectors", "in": "query", "required": false, "description": "CSS selectors to hide", "schema": { "type": "string" } }, { "name": "download", "in": "query", "required": false, "description": "Content-Disposition attachment", "schema": { "type": "boolean" } }, { "name": "filename", "in": "query", "required": false, "description": "File name", "schema": { "type": "string" } }, { "name": "response", "in": "query", "required": false, "description": "json = base64 data URI", "schema": { "type": "string" } } ], "responses": { "200": { "description": "PDF", "content": { "application/pdf": {} } } } }, "post": { "summary": "Render your HTML to PDF (invoices, reports, tickets)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "html": "

Invoice #1001

Total: $49

", "paper": "A4", "margin": "15mm", "footer_html": "

Page of

" } } } }, "responses": { "200": { "description": "PDF" } } } } } }