Convert to PDF

Convert to PDF is a REST API tool that accepts a wide range of file types as input and reliably converts each into a standardized PDF document.

Try Now with API Lab

Start right from your browser - upload files, choose parameters, generate code, and send API Calls directly from API Lab! Visit Get Started to receive your free API Key.

Parameters

Api-Key

POST

/pdf

curl -X POST "https://api.pdfrest.com/pdf" \ 
  -H "Accept: application/json" \ 
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \curl -X POST "https://api.pdfrest.com/pdf" \ 
  -H "Accept: application/json" \ 
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \

Response

Once you've sent your POST request and received a valid response, you can download your output file using the output URL.

Get the best with pdfRest

Robust Format Support

This one single tool will take just about any file you throw its way and convert the contents to a PDF document. Works with all of the following:

Word (.doc, .docx)
Excel (.xls, .xlsx)
PowerPoint (.ppt, .pptx)
PostScript (.ps)
Encapsulated PostScript (.eps)
JPEG (.jpg, .jpeg)
TIF (.tif, .tiff)
BMP (.bmp)
PNG (.png)
HTML (.html, from URL)

Standardized PDF Documents

Not all PDFs are created equal - many PDF conversion tools lack the support to generate complex PDF documents that meet all requirements by the International Organization for Standardization (ISO). This can lead to painful problems downstream in your workflows.

With pdfRest’s Convert to PDF Tool, all files are optimized using high-quality Adobe® PDF Library™ technology to ensure consistent and reliable compliance with PDF ISO 32000 specifications.

Adjustable Controls

Fine-tune PDF output files and optimize for your specific use cases with adjustable parameters to support:

Creating tagged PDFs from Office files
Compressing and downsampling PDF images
Setting page size, margins, and orientation for HTML conversion
And more!

See documentation for full details

Start from Code Examples

First, you'll need an API Key - visit Get Started to:
- Stay anonymous with a Guest API Key for 50 free API Calls
- Sign up for an upgraded API Key with unlimited, continuous service
Choose your programming language
Copy and paste the code to your project
Update Api-Key field with your unique API Key
Update file with the local path to your input
Run this code to send an API Call

See more code examples in our
GitHub repository

Try pdfRest with just a few clicks
Download our Postman Collection

curl -X POST "https://api.pdfrest.com/pdf" \
  -H "Accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  -F "file=@../Sample_Input/strawberries.jpg" \
  -F "output=example_out"curl -X POST "https://api.pdfrest.com/pdf" \
  -H "Accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  -F "file=@../Sample_Input/strawberries.jpg" \
  -F "output=example_out"

Customize Your Solution

File

The file parameter allows you to select a local file to be uploaded to pdfRest’s processing server for conversion.

This is a required field unless you include the id or url parameter instead.

Id

The id parameter allows you to submit a resource ID for a file already on the processing server. Each of our API Tools assigns a unique resource ID to all uploaded input files and generated output files and returns these IDs in the response to each API Call. This allows you to store the IDs from one call and submit them to the next, chaining requests together without having to download intermediate files between requests.

This is a required field unless you include the file or url parameter instead.

URL

The url parameter lets you convert a web page to a PDF directly from its URL and does not require uploading or referencing the id of a file.

This is a required field for web page conversion from URL only.

Output

The output parameter lets you provide a filename (without extension) for your new PDF.

This is a required field.

Compression

The compression parameter lets you choose between “lossy” and “lossless” image compression. “Lossy” will sacrifice image quality for a drop in data size, whereas “lossless” will retain image quality.

Downsample

The downsample parameter lets you adjust downsampling of image resolution when converting from PostScript, Microsoft Office files, or HTML. Downsampling can be adjusted or completely switched off.

Tagged PDF

The tagged_pdf parameter allows you to create a tagged PDF when converting a Microsoft Office file. A tagged PDF enables accessibility features in supported viewers.

Page Size

The page_size lets you select from a list of standard page sizes when converting from HTML to PDF, including: letter, legal, ledger, A3, A4, A5.

Page Margin

The page_margin parameter lets you set the page margin size in inches or millimeters when converting from HTML to PDF.

Tip: Setting this to zero allows content to flow to the edges of the document, allowing a PDF to match the appearance of a website.

Page Orientation

The page_orientation parameter lets you set the page orientation to either landscape or portrait when converting from HTML to PDF.

Web Layout

The web_layout lets you select the target layout of a web page to render when converting from HTML to PDF.

This has the biggest impact for web pages that use responsive design to adjust content to fit different screen resolutions. Choose from desktop, tablet, or mobile layouts.

See Documentation

Generate a self-service API Key now!

Create your FREE Guest API Key to start processing PDFs in seconds, only possible with pdfRest.

Get Started For Free Compare Plans

Logged in as

Log In

Recover password

Let's get started

Generate a dedicated API Key by creating an account or starting as a guest.

Create an Account

OR

Be our Guest

Account information

Which primary language will you use to call the pdfRest service?

Which API Tool(s) are you interested in?

What problems are you hoping to solve with pdfRest?

How did you hear about pdfRest?