Amount: $100.00
", "pageFormat": "Letter", "marginTop": "20mm", "marginBottom": "20mm", "marginLeft": "25mm", "marginRight": "25mm" } ``` **Example: Batch-convert multiple URLs** ```json { "inputType": "urls", "urls": [ "https://example.com/page-1", "https://example.com/page-2", "https://example.com/page-3" ], "pageFormat": "A4", "maxConcurrency": 2, "waitUntil": "networkidle", "outputFileName": "report" } ``` ### Input parameters | Parameter | Type | Default | Description | |---|---|---|---| | `inputType` | string | `url` | What to convert: `html`, `url`, or `urls` | | `html` | string | — | Raw HTML content to convert (when `inputType` is `html`) | | `url` | string | — | URL to convert (when `inputType` is `url`) | | `urls` | array | — | Up to 20 public HTTP(S) URLs (when `inputType` is `urls`) | | `pageFormat` | string | `A4` | Page size: `A4`, `A3`, `A5`, `Letter`, `Legal`, `Tabloid` | | `landscape` | boolean | `false` | Use landscape orientation | | `marginTop` | string | `10mm` | Top margin (e.g., `10mm`, `1cm`, `0.5in`) | | `marginBottom` | string | `10mm` | Bottom margin | | `marginLeft` | string | `10mm` | Left margin | | `marginRight` | string | `10mm` | Right margin | | `printBackground` | boolean | `true` | Include background colors and images | | `scale` | number | `1` | Page scale factor (0.1–2.0) | | `displayHeaderFooter` | boolean | `false` | Show header/footer templates | | `headerTemplate` | string | — | HTML template for page header | | `footerTemplate` | string | — | HTML template for page footer | | `waitForSelector` | string | — | CSS selector to wait up to 15 seconds for before PDF generation | | `failOnSelectorTimeout` | boolean | `false` | Fail an item when its selector does not appear; otherwise warn and continue | | `waitForTimeout` | integer | `0` | Extra wait time (ms) after readiness and selector checks | | `waitUntil` | string | `load` | Readiness milestone: `domcontentloaded`, `load`, or `networkidle`. Default `load` does not require background network activity to stop; explicit `networkidle` still requires idle and fails on timeout. | | `navigationTimeoutSecs` | integer | `60` | Per-item navigation/readiness timeout (5–120 seconds) | | `maxConcurrency` | integer | `2` | Number of isolated batch items processed at once (1–5) | | `outputFileName` | string | `output` | Prefix for PDF filenames | | `fullPage` | boolean | `false` | Capture full scrollable page height | ### Output examples Each converted page produces one dataset record: ```json { "index": 1, "source": "https://example.com", "pdfKey": "output.pdf", "pdfUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/output.pdf", "fileSizeKb": 245.3, "success": true, "durationMs": 2841, "errorStage": null, "error": null } ``` For batch conversions (`inputType: urls`), PDFs are named `{outputFileName}-001.pdf`, `{outputFileName}-002.pdf`, etc. Dataset rows and filenames always follow input order even when pages run concurrently. Invalid or failed URLs produce diagnostic rows and are not charged as converted pages. Partial-success batches finish successfully; if every item fails, the Actor writes all diagnostic rows and then fails the run. ### Tips for best results - 💡 **Start small**: Test with a single URL before batch-converting many pages - 🎨 **Background images not showing?** Make sure `printBackground: true` is set - ⏳ **Dynamic content not loaded?** Choose the appropriate `waitUntil`, use `waitForSelector` for a content marker, or add `waitForTimeout` (e.g., `2000` for 2 seconds). Enable `failOnSelectorTimeout` when missing content must fail the item. - 📐 **Full-page captures**: Set `fullPage: true` to avoid page breaks and get one continuous PDF - 📝 **Headers and footers**: Set `displayHeaderFooter: true` and provide HTML templates with `.pageNumber` and `.totalPages` CSS classes - 💾 **Custom filenames**: Use `outputFileName` to set a descriptive prefix for your PDFs - 🔢 **Scaling**: Use `scale: 0.8` to fit more content per page, or `scale: 1.2` to increase text size ### Integrations **HTML to PDF Converter → Google Drive:** Schedule the actor to convert your weekly reports to PDF, then use a Zapier webhook to save them to Google Drive automatically. Perfect for archiving or sharing with stakeholders who need offline copies. **HTML to PDF Converter → Email:** Convert HTML email templates to PDF for preview and approval. Use the PDF URL in a Make (Integromat) workflow to attach it to an email or Slack notification. **HTML to PDF Converter → Slack notifications:** Trigger the actor via API after deploying a dashboard update. Send the PDF URL to a Slack channel so your team always has the latest report as a shareable PDF. **Scheduled page archiving:** Set a daily cron schedule on Apify to automatically archive web pages that change frequently (product pages, news articles, pricing pages). Each run stores a dated PDF snapshot. **Invoice generation pipeline:** Use the HTML string input mode to generate PDFs from invoice HTML templates. Combine with Apify's API to call this actor from your backend after each payment — get a PDF URL in the response to store in your database. ### API usage Use the Apify API to run HTML to PDF Converter programmatically from your own code. #### Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('automation-lab/html-to-pdf-converter').call({ inputType: 'url', url: 'https://example.com', pageFormat: 'A4', printBackground: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log('PDF URL:', items[0].pdfUrl); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient(token='YOUR_APIFY_TOKEN') run = client.actor('automation-lab/html-to-pdf-converter').call(run_input={ 'inputType': 'url', 'url': 'https://example.com', 'pageFormat': 'A4', 'printBackground': True, }) items = client.dataset(run['defaultDatasetId']).list_items().items print('PDF URL:', items[0]['pdfUrl']) ``` #### cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~html-to-pdf-converter/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "inputType": "url", "url": "https://example.com", "pageFormat": "A4", "printBackground": true }' ``` ### Use with AI agents via MCP HTML to PDF Converter is available as a tool for AI assistants that support the [Model Context Protocol (MCP)](https://docs.apify.com/platform/integrations/mcp). Add the Apify MCP server to your AI client — this gives you access to all Apify actors, including this one: #### Setup for Claude Code ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=automation-lab/html-to-pdf-converter" ``` #### Setup for Claude Desktop, Cursor, or VS Code Add this to your MCP config file: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=automation-lab/html-to-pdf-converter" } } } ``` Your AI assistant will use OAuth to authenticate with your Apify account on first use. #### Example prompts Once connected, try asking your AI assistant: - "Use automation-lab/html-to-pdf-converter to convert https://example.com/invoice to a PDF in Letter format" - "Convert this HTML invoice template to a PDF with 20mm margins and a footer showing page numbers" - "Batch-convert these 5 URLs to PDFs: \[list] and store them with the filename prefix 'monthly-report'" Learn more in the [Apify MCP documentation](https://docs.apify.com/platform/integrations/mcp). ### Legality Yes, converting publicly accessible web pages to PDF for personal use, archiving, or internal purposes is generally considered legal in most jurisdictions. Always respect the website's `robots.txt` and terms of service. Avoid bulk-converting copyrighted content for redistribution. HTML to PDF Converter accesses only the URLs and HTML content you provide and does not crawl links. URL mode is designed for anonymously accessible public HTTP(S) pages; this Actor does not accept credentials, cookies, or login sessions. Always ensure you have the right to capture the content you're converting. ### Data handling, retention, and support The Actor processes only the HTML and URLs supplied in the run. HTML stays inside the run's browser process; URL mode sends ordinary anonymous browser requests to the selected websites. No AI provider, proxy product, paid content API, credential service, or external database receives the input. The Actor stores PDFs in the run key-value store, conversion diagnostics in the run dataset, and operational messages in run logs. Failed operations send sanitized diagnostic input, exceptions, and Actor/build/run IDs to our private GlitchTip service for repair. Secret fields and URL query strings are removed, and reports are retained for 30 days. It creates no separate content cache. Apify storages follow the retention and deletion settings of your Apify account and can be deleted through Apify Console or API controls. Do not place passwords, session tokens, or other secrets in URLs. For help, use the **Issues** tab on this Actor's Apify Store page and include a reproducible input with sensitive values removed. ### FAQ **How fast does conversion take?** A single page typically converts in 5–20 seconds depending on complexity, rendering time, and network conditions. Batch jobs process up to `maxConcurrency` pages in isolated browser contexts (default 2, maximum 5), so total time depends on the slowest pages and your readiness settings. **How much does it cost per PDF?** A single conversion costs approximately $0.01 (start fee + one page at FREE tier). Batch runs are more efficient — $0.05 for 10 pages, $0.25 for 50 pages on the free tier. Paid plans offer lower per-page rates (see pricing table above). **Why is my PDF missing fonts or background colors?** If fonts are missing, the web page may use custom web fonts that require the full page to load. Try setting `waitForTimeout: 2000` to give fonts time to download. If background colors or images are missing, make sure `printBackground: true` is set. **Why are some pages blank or showing an error?** Some sites block headless browsers or require authentication. If a page consistently fails, it may have bot protection. For pages with slow JavaScript rendering, try adding a `waitForSelector` targeting an element that appears after the content loads, or increase `waitForTimeout`. **Can I convert password-protected pages?** No — the actor accesses pages as an anonymous user. Password-protected or login-gated pages will show the login screen in the PDF. To convert authenticated pages, you would need to handle authentication separately before passing a session cookie. **How do I add headers and footers?** Set `displayHeaderFooter: true` and provide HTML templates in `headerTemplate` and `footerTemplate`. Use CSS class `.pageNumber` for the current page number and `.totalPages` for total pages. Example footer: `This is a PDF generated from HTML.
", "url": "https://apify.com", "urls": [ "https://apify.com", "https://apify.com/store" ], "pageFormat": "A4", "landscape": false, "marginTop": "10mm", "marginBottom": "10mm", "marginLeft": "10mm", "marginRight": "10mm", "printBackground": true, "scale": 1, "headerTemplate": "", "footerTemplate": "", "displayHeaderFooter": false, "waitForSelector": "", "failOnSelectorTimeout": false, "waitForTimeout": 0, "waitUntil": "load", "navigationTimeoutSecs": 60, "maxConcurrency": 2, "outputFileName": "output", "fullPage": false } ``` # Actor output Schema ## `overview` (type: `string`): Dataset rows for every submitted HTML or URL source. ## `files` (type: `string`): Key-value store containing each successfully generated PDF. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the 'This is a PDF generated from HTML.
", "url": "https://apify.com", "urls": [ "https://apify.com", "https://apify.com/store" ], "pageFormat": "A4", "marginTop": "10mm", "marginBottom": "10mm", "marginLeft": "10mm", "marginRight": "10mm", "outputFileName": "output" }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/html-to-pdf-converter").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace 'This is a PDF generated from HTML.
", "url": "https://apify.com", "urls": [ "https://apify.com", "https://apify.com/store", ], "pageFormat": "A4", "marginTop": "10mm", "marginBottom": "10mm", "marginLeft": "10mm", "marginRight": "10mm", "outputFileName": "output", } # Run the Actor and wait for it to finish run = client.actor("automation-lab/html-to-pdf-converter").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "inputType": "url", "html": "This is a PDF generated from HTML.
", "url": "https://apify.com", "urls": [ "https://apify.com", "https://apify.com/store" ], "pageFormat": "A4", "marginTop": "10mm", "marginBottom": "10mm", "marginLeft": "10mm", "marginRight": "10mm", "outputFileName": "output" }' | apify call automation-lab/html-to-pdf-converter --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,automation-lab/html-to-pdf-converter" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer