**Transform HTML into pixel-perfect PDFs effortlessly.** Whether you are generating professional invoices for your e-commerce platform, dynamic financial reports for your startup, or customized tickets and certificates, don't waste time wrestling with complex PDF libraries and headless browsers. Hand over the rendering to us and focus on building your core product. ## 🌟 Key Features - **Built on Web Standards:** Uses the familiar technologies you already know: HTML, CSS, and JavaScript. - Full support for modern layouts (Flexbox, CSS Grid), SVGs, and custom WebFonts. If it looks good in Chromium, it looks perfect in your PDF. - **Dedicated Invoice Endpoint:** Skip the HTML! Send us a JSON payload with your e-commerce order details to `/api/invoice` and we instantly return a beautifully designed, Nordic-style PDF invoice ready for your customers. - **Developer-Friendly API:** A streamlined and straightforward JSON API that is extremely easy to integrate into any tech stack, yet fully configurable for complex enterprise needs. - **Blazing Fast & Reliable:** Powered by robust cloud infrastructure to ensure high availability, low latency, and limitless scalability. Built for production workloads with absolutely zero DevOps maintenance required on your end. - **Advanced Customization:** Enjoy full control over margins, page format (A4, Letter, Legal, Tabloid, etc.), background printing options, and more. --- ## 🚀 Getting Started (Usage Examples) HTML2PDF works easily with your favourite programming language and libraries. Here are some examples of how to consume the endpoints directly. ### 1. Using cURL (Bash / Terminal) ```bash # Render from a public URL curl -X POST https://fast-url-html-to-pdf-api.p.rapidapi.com/api/generate \ -H "Content-Type: application/json" \ -H "x-rapidapi-host: fast-url-html-to-pdf-api.p.rapidapi.com" \ -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \ -d '{ "url": "https://example.com", "format": "Letter", "printBackground": true }' --output document.pdf # Render from raw HTML markup curl -X POST https://fast-url-html-to-pdf-api.p.rapidapi.com/api/generate \ -H "Content-Type: application/json" \ -H "x-rapidapi-host: fast-url-html-to-pdf-api.p.rapidapi.com" \ -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \ -d '{ "html": "

Hello World!

This is my awesome PDF.

", "format": "A4", "margins": { "top": "20px", "bottom": "20px", "left": "15px", "right": "15px" } }' --output document.pdf # Generate a modern invoice PDF from JSON data curl -X POST https://fast-url-html-to-pdf-api.p.rapidapi.com/api/invoice \ -H "Content-Type: application/json" \ -H "x-rapidapi-host: fast-url-html-to-pdf-api.p.rapidapi.com" \ -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \ -d '{ "orderNumber": "INV-2026-001", "items": [{"name": "Web Design Services", "quantity": 1, "price": 500, "total": 500}] }' --output invoice.pdf ``` ### 2. Node.js (Axios) ```javascript const axios = require("axios"); const fs = require("fs"); async function generatePDF() { const options = { method: "POST", url: "https://fast-url-html-to-pdf-api.p.rapidapi.com/api/generate", headers: { "content-type": "application/json", "x-rapidapi-host": "fast-url-html-to-pdf-api.p.rapidapi.com", "x-rapidapi-key": "YOUR_RAPIDAPI_KEY" }, data: { url: "https://en.wikipedia.org", format: "A4", printBackground: true }, responseType: "arraybuffer", // Crucial for receiving binary file data }; try { const response = await axios.request(options); fs.writeFileSync("output.pdf", response.data); console.log("PDF generated successfully!"); } catch (error) { console.error(error); } } generatePDF(); ``` ### 3. Python (Requests) ```python import requests url = "https://fast-url-html-to-pdf-api.p.rapidapi.com/api/generate" payload = { "html": "

Generated with Python

HTML2PDF is awesome!

", "format": "A4", "margins": { "top": "10mm", "bottom": "10mm", "left": "10mm", "right": "10mm" }, "printBackground": True } headers = { "content-type": "application/json", "x-rapidapi-host": "fast-url-html-to-pdf-api.p.rapidapi.com", "x-rapidapi-key": "YOUR_RAPIDAPI_KEY" } response = requests.post(url, json=payload, headers=headers) if response.status_code == 200: with open("output.pdf", "wb") as f: f.write(response.content) print("PDF saved.") else: print(f"Error: {response.text}") ``` --- ## 🛠 Configuration Parameters Our API expects a simply structured JSON payload. You must provide exactly one source (`html` OR `url`). | Parameter | Type | Required | Description | Example | | :--- | :--- | :--- | :--- | :--- | | `html` | `string` | **Yes** (or url) | The raw HTML markup you want to convert to PDF. | `"

Hello!

"` | | `url` | `string` | **Yes** (or html) | A publicly accessible URL to navigate to and render. | `"https://apple.com"`| | `format` | `string` | Optional | Page format for the PDF document. | `"A4"`, `"Letter"`, `"Legal"` | | `printBackground` | `boolean`| Optional | Include CSS background colors and images in the PDF. | `true` or `false` (default: `true`) | | `margins.top` | `string` | Optional | Page top margin (absolute CSS units accepted). | `"20px"`, `"1cm"`, `"10mm"` | | `margins.bottom`| `string` | Optional | Page bottom margin. | `"20px"` | | `margins.left` | `string` | Optional | Page left margin. | `"15px"` | | `margins.right` | `string` | Optional | Page right margin. | `"15px"` | ### Invoice Endpoint Parameters (`/api/invoice`) The customized Invoice endpoint expects structured JSON data instead of raw HTML: | Parameter | Type | Required | Description | Example | | :--- | :--- | :--- | :--- | :--- | | `orderNumber` | `string` | **Yes** | The unique identifier for the invoice. | `"INV-10023"` | | `items` | `array` | **Yes** | List of items to bill (must contain `name`, `quantity`, `price`, `total`). | `[{"name": "Item", "quantity": 1, "price": 10, "total": 10}]` | | `date` | `string` | Optional | The date of the invoice (defaults to today). | `"2026-02-22"` | | `logoUrl` | `string` | Optional | Public URL to your company logo. | `"https://example.com/logo.png"` | | `customer` | `object` | Optional | Customer information (`name`, `email`, `address`). | `{"name": "John Doe"}` | | `summary` | `object` | Optional | Financial summary (`subtotal`, `tax`, `shipping`, `grandTotal`). | `{"grandTotal": 99.99}` | --- ## ❓ Frequently Asked Questions (FAQ) **1. Is it secure? Do you store my data?** Absolutely. HTML2PDF does NOT store the HTML strings, generated PDFs, or URLs provided in the requests. Renderings run securely in an isolated instance and are instantly destroyed after the PDF is delivered. **2. Does it support custom fonts and SVGs?** Yes! As long as the fonts are imported correctly (e.g., via Google Fonts or base64 encoded strings in CSS) and the SVGs are valid, HTML2PDF will render them perfectly just like a modern browser would. **3. What happens if the generated PDF is very large or complex?** The API is optimized for speed, but extremely large HTML payloads or unoptimized external assets (like huge background images) may take longer. Our service will await network idle states before taking the snapshot, ensuring everything is loaded fully. **4. My PDF looks different from my browser.** Ensure that `printBackground: true` is set in your request body, as backgrounds are omitted by default in standard browser printing. Additionally, verify that your CSS does not have `@media print` query restrictions that hide your layout segments. ---