HTML to PDF API

Convert your HTML or web pages into high-quality PDFs effortlessly. Our HTML to PDF API is designed for developers and businesses who need accurate, reliable, and scalable PDF generation. It delivers pixel-perfect rendering, supports fillable form fields, and handles complex layouts.

Start with trial API Documentation

NODE.JS

CURL

PYTHON

PHP

JAVA

RUBY

350,000+Documents processed

1,000+Developers using the API

1.6sAverage processing time

99.9%Uptime

Main Features

Explore the core rendering capabilities that make HTML to PDF conversion reliable at any scale.

Powered by Google Chrome

The API uses the latest Chrome rendering engine to generate PDFs that look exactly as they do in the browser, ensuring pixel-perfect accuracy with full CSS and JavaScript support.

Responsive Page Support

Easily convert responsive designs into PDFs that adapt beautifully across mobile, tablet, and desktop layouts. Your content will maintain its layout and readability on every device.

Framework-Friendly

Seamlessly render pages built with your favorite front-end frameworks and tools such as React, Angular, Tailwind, Vue.js, and more. No additional setup is required.

Create Fillable PDFs

Add Interactivity and Collect User Data from Your PDFs

✓ Transform HTML inputs into PDF fields

Convert standard HTML input elements directly into interactive PDF fields without any additional configuration.

✓ Support for all the common field types

Create fully interactive PDFs with text fields, date fields, dropdowns, radio buttons, checkboxes, multi-select lists, text areas, and digital signature fields.

✓ Customize appearance and behavior

Adjust the look and feel of each field by defining background colors, borders, and font sizes. Control field behavior with standard validations, prefilled values, and more. For practical examples of styling and configuration, see our fillable fields guide.

✓ Combine with Other Endpoints

Use it alongside other endpoints such as Flatten PDF or Extract Data to create a complete workflow for collecting, processing, and securing PDF form data.

Additional Customizations

Fine-tune rendering, layout, and interactivity to match exactly how your documents should look and behave.

Fine-Tune Every Detail

Control page margins, headers, and footers to achieve the perfect layout for your PDFs.

Flexible Page Options

Generate PDFs using standard paper sizes or define custom page width and height. Select specific page ranges to include only the content you need.

Enhanced Rendering Control

Enable lazy loading for images, inject custom JavaScript or CSS scripts, and set page delays to ensure complete content rendering.

Advanced Interactions

Wait for specific elements to appear or trigger clicks before capturing the page, giving you full control over dynamic and interactive content.

Full API Parameter List

Html

String

The raw HTML content to be converted into a PDF. This can include full HTML documents or fragments, with support for inline styles, custom fonts, JavaScript, and media queries. The HTML will be rendered as a PDF using our headless browser.

Url

String

The public URL of the web page to convert into a PDF. The page must be accessible over the internet and should return a complete HTML document.

Json Response

Bool

When set to true, the API will return a JSON response instead of streaming the generated PDF file. The JSON includes a secure download URL and metadata about the PDF. This is useful for workflows where you want to store, inspect, or delay the download of the PDF rather than receiving it immediately in the response body.

Page Size Type

Enum

Specifies the paper size for the generated PDF. Such as A4, Tabloid and Letter.

Page Ranges

String

Defines the page range to include in the PDF.

Width

Number

Sets a custom width for the generated PDF in pixels. This overrides the default paper size and is typically used for responsive or non-standard layouts. When using width, you should also set the height parameter. This option is ideal for precise control over PDF dimensions.

Height

Number

Sets a custom height for the generated PDF in pixels. Use this to define non-standard page sizes for dynamic layouts. When specifying height, you should also provide the width parameter. This allows full control over the final PDF dimensions and layout.

Orientation

Enum

Specifies the page orientation for the generated PDF. Accepted values are portrait and landscape. This setting affects the layout and flow of content across the page, especially for horizontal designs. The API defaults to portrait if it is not specified.

Scale

Number

Defines the page scale factor used when generating the PDF. Accepts values between 0.1 and 2.

Header

String

The HTML content to display as a fixed header on every page of the generated PDF. This can include text, logos, tables, or styled elements, and supports inline CSS for full customization. Ideal for adding company branding, document titles, page numbers, or dates to the top of each page.

Footer

String

The HTML content to display as a fixed footer on every page of the generated PDF. Supports text, images, tables, and inline CSS for full customization. Common uses include adding page numbers, disclaimers, timestamps, or company contact information at the bottom of each page.

Margin

Object

Sets the page margins for the generated PDF in pixels. Accepts an object with optional properties: top, right, bottom, and left. This allows precise control over content spacing and layout.

Timeout

Number

Specifies how long the API waits (in milliseconds) for the HTML content to fully load and render before generating the PDF. This option is useful for pages with dynamic or slow-loading content. The default value is 15 minutes, and in most cases you won't need to change it. You may want to reduce the timeout when debugging, especially if a page is hanging and you want the request to fail faster.

Delay

Number

Adds a delay (in milliseconds) before converting the HTML content into a PDF. This is useful when asynchronous content requires additional time to fully render.

Load Images

Boolean

When enabled, the API waits for all images to finish loading before generating the PDF. This helps prevent missing or partially rendered images.

Javascript

String

Defines custom JavaScript code to be executed after the HTML content is loaded but before the PDF is generated.

Css

String

Custom CSS styles to apply to the HTML content before rendering it to PDF. This allows you to override default styles, add branding, adjust layouts, or control print-specific formatting.

Emulate Media Type

Enum

Sets the CSS media type used when rendering the HTML to PDF. Accepted values are screen and print. This controls which CSS media queries are applied. Use print to apply print-specific styles (e.g., hide navigation, adjust layout), or screen to render the PDF as it appears in a browser.

Wait For Selector

String

Delays PDF generation until a specific CSS selector is present in the DOM. The renderer will wait until the element matching the selector appears or until the timeout is reached.

Click Selector

String

Waits for an element matching the given CSS selector to appear on the page, then simulates a click before rendering the PDF. Useful for triggering UI interactions such as opening modals, expanding sections, loading hidden content, or accepting cookie banners. This action occurs after the page loads but before PDF generation begins.

Click Selector Chain Setup

Array

Provides advanced control for handling cookie banners, consent dialogs, pop-ups, and multi-step UI interactions before the PDF is generated. This option extends and improves upon the simpler clickSelector parameter by allowing a sequence of interactions to be executed in order. When this parameter is defined, the clickSelector field is ignored.

Wait For Network Idle

Boolean

When set to true, this delays PDF generation until the page has no active network connections. This ensures that all resources such as images, fonts, and JavaScript-loaded content are fully loaded before rendering. It is especially useful for pages with asynchronous or delayed content loading.

User Agent

String

Specifies the user agent string used when rendering the HTML, allowing you to control how the content is served and displayed.

Http Headers

Object

Defines custom HTTP headers to be sent when loading the HTML or URL for PDF generation. Useful for passing authentication tokens, cookies, or custom headers required by your web application.

Enable Form Fields

Boolean

When set to true, the generated PDF will include interactive AcroForm fields that users can fill out directly in PDF viewers such as Adobe Acrobat or browser-based PDF readers. This is ideal for creating fillable forms, applications, contracts, or surveys from HTML input elements like <input>, <select> and <textarea>.

Pre Signed Url Expires In

Number

Allows you to temporarily view the generated PDF in the browser without authorized access, using a secured URL that expires after the time you specify. The value is provided in seconds, and the maximum expiration time is 1 day.

Metadata

Object

Adds custom metadata to the document record. This information is not embedded in the PDF file itself, but can be used for tracking, tagging, or associating the document with related data in your system. You may include any key-value pairs relevant to your application.

Frequently Asked Questions

Learn more about PDF Gate.

It is a tool or an online service that can transform web content (HTML, CSS) into a PDF file. It is used by software teams to generate reports, invoices, or other documents because of its simplicity.

Yes. Our API includes dedicated endpoints for PDF watermarking and encryption. After generating a PDF from HTML, you can apply password protection and/or a watermark using the appropriate endpoints.

Yes, batch conversions are supported. Be sure to manage concurrency according to the limits defined in your plan.