# ⚡ ConvertToPDF - HTML to PDF API **ConvertToPDF** is an ultra-fast, enterprise-grade HTML to PDF rendering API built on a bare-metal Rust engine (`Axum` + CDP WebSocket) and headless Chromium. It is designed specifically for SaaS developers, e-commerce platforms, and automated workflows that demand sub-100ms document generation without the DevOps overhead of managing headless Chrome instances. --- ## 🌟 Key Features * **⚡ Sub-60ms Baseline Speed:** Direct memory stream rendering without browser cold-start tax. * **🎨 Full CSS3 & Print Media Support:** Native handling of `@page` rules, Flexbox, CSS Grid, custom web fonts, and margins. * **🛡️ Production Hardened:** Isolated tab execution with automated memory recycling and hard execution timeouts (10s). * **📦 Clean Binary Response:** Delivers raw `application/pdf` streams ready to download or pipe to storage (AWS S3, Cloudflare R2, GCP). --- ## 🚀 Quick Start Example (cURL) ```bash curl -X POST "https://converttopdf-html-to-pdf-converter.p.rapidapi.com/v1/html" \ -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \ -H "X-RapidAPI-Host: converttopdf-html-to-pdf-converter.p.rapidapi.com" \ -H "Content-Type: application/json" \ -d '{ "html": "<html><body>

Invoice #1024

Amount Due: $150.00

</body></html>", "margins": "10mm", "landscape": false, "filename": "invoice-1024.pdf" }' \ --output invoice.pdf ``` --- ## 🛠️ Request Payload Parameters | Field | Type | Required | Default | Description | | :--- | :--- | :--- | :--- | :--- | | `html` | `string` | **Yes** | — | Raw HTML content or template string to convert. | | `margins` | `string` | No | `"0.4in"` | Page margins (e.g., `"10mm"`, `"0.5in"`, `"20px"`). | | `landscape` | `boolean` | No | `false` | Set to `true` for landscape orientation, `false` for portrait. | | `filename` | `string` | No | `"document.pdf"` | Suggested filename returned in `Content-Disposition` header. | --- ## 💻 Integration Snippets ### Node.js / JavaScript (Fetch) ```javascript const response = await fetch('https://converttopdf-html-to-pdf-converter.p.rapidapi.com/v1/html', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', 'X-RapidAPI-Host': 'converttopdf-html-to-pdf-converter.p.rapidapi.com' }, body: JSON.stringify({ html: '

Order Confirmation

Thank you for your purchase!

', margins: '12mm' }) }); const pdfArrayBuffer = await response.arrayBuffer(); // Write buffer to disk or upload directly to S3/Cloudflare R2 ``` ### Python (Requests) ```python import requests url = "https://converttopdf-html-to-pdf-converter.p.rapidapi.com/v1/html" headers = { "Content-Type": "application/json", "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY", "X-RapidAPI-Host": "converttopdf-html-to-pdf-converter.p.rapidapi.com" } payload = { "html": "<html><body>

Receipt #5001

Total Paid: $49.00

</body></html>", "margins": "10mm", "landscape": False } response = requests.post(url, json=payload, headers=headers) if response.status_code == 200: with open("receipt.pdf", "wb") as f: f.write(response.content) print("PDF successfully saved!") ``` --- ## 💡 Performance Best Practices 1. **Inline Critical CSS & Fonts:** To achieve sub-100ms render speeds, use inline `<style>` blocks or base64 embedded fonts. Fetching external heavy CDNs (like full Tailwind CSS bundles or remote Google Fonts) adds network round-trip overhead. 2. **Page Breaks:** Use standard print CSS to force page breaks cleanly: ```css .page-break { page-break-before: always; } ``` --- ## 🔒 Security & Data Privacy * **Zero Storage / 100% Stateless:** HTML inputs and generated PDF binaries are processed purely in volatile server memory (RAM) and are immediately dropped after streaming back to the client. We do **not** log or store rendered documents. * **HTTPS Encrypted:** All data in transit is encrypted using standard TLS 1.3 encryption.