Watermark PDF with Text and Images, API Tool

Try Now with API Lab

Start right from your browser - upload files, choose parameters, generate code, and send API Calls directly from API Lab!

Request

POST

Headers

Api-Key

Don't have a key? Create an account to get one.

Response-Type

Poll for the status of a request by ID. Request IDs can be found in the JSON response of POST requests sent to any pdfRest endpoint.

Required Parameters

file

PDF file to be uploaded and watermarked

Alphanumeric ID (UUID) of existing file on server to be processed

watermark_text

The text to apply to the input document as a watermark

watermark_file

PDF file to apply to the input document as a watermark

watermark_file_id

Alphanumeric ID (UUID) of existing PDF file on server to be applied as a watermark

Optional Parameters

output

Name of the generated output file, without extension

font

Font to use for a text watermark

text_size

Size of text for a text watermark

text_color_rgb

Comma separated Red, Green, Blue values for a text watermark. NOTE: Cannot be used with text_color_cmyk

text_color_cmyk

Comma separated Cyan, Magenta, Yellow, Key (Black) values for a text watermark. NOTE: cannot be used with text_color_rgb

Fill all CMYK values to preview color.

watermark_file_scale

Scale applied to resize the content of a pdf watermark file

opacity

Opacity value for both text and file watermarks

Horizontal offset in PDF units from the center of page for both text and file watermarks (72 units = 1 inch)

Vertical offset in PDF units from the center of page for both text and file watermarks (72 units = 1 inch)

rotation

Rotation in degrees to be applied to both text and file watermarks

Code

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

Response

The response for your API Call will display here.

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

Build Your Solution

You have document processing problems, we have Solutions. Explore the many ways pdfRest can align your documents with your business objectives.

Browse all solutions

Access PDF Processing Power with AI Magic

Integrate pdfRest with Microsoft Power Automate

Integrate PDF API Tools with Salesforce Apex Code

Control your Backend with pdfRest API Toolkit Self-Hosted

Secure PDF Documents with Protected Watermarks

A copyright mark is applied to a PDF document to protect a person's original ideas and creative designs

Preserve Copyright with PDF Watermarking

Why is pdfRest the best API to watermark PDF?

pdfRest offers the best solution for watermarking PDF documents, because it supports both text and images, full customization, and an extensive font list.

Supports Text and Images

Watermark PDF is your one-stop-shop to easily add both text-based watermarks and image-based watermarks to a PDF. Simply upload your PDF to be watermarked, and choose between uploading an image file (in PDF format) or setting the watermark_text field to use as your watermark. If your image file is in a different format than PDF, simply process it first with the Convert to PDF API Tool.

Fully Customizable

Just like Adobe® Acrobat™, Watermark PDF gives you full access to apply and adjust your watermark with precision. For text-based watermarks, choose your font, text size, and text color. For image-based watermarks, scale your image to any size. For both text and image watermarks, adjust the opacity, vertical and horizontal position, and rotation value.

Extensive Font Support

When applying a watermark using text, choose from over 70 supported font options. Browse the Font List to find the best fit font for your watermark. If you don't see the font you're looking for, just let us know, and we'll be happy to look into the best ways to support your specific requirements.

Check out other videos

Start from Code Examples

See more code examples in our GitHub repository

Need more help?

Start with a Tutorial for step-by-step guidance

How to Watermark PDF in .NET with C#

How to Watermark PDF with cURL

How to Watermark PDF with Java

How to Watermark PDF with JavaScript in NodeJS

How to Watermark PDF with PHP

How to Watermark PDF with Python

6 items

Customize Your Solution

Learn about the parameters for this tool to create your custom solution.

File

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

See Documentation

The id parameter allows you to submit a resource ID generated by one of our API Tools. Each of our API Tools assigns a unique resource ID to your output file(s), allowing you to chain requests together without having to download intermediate files between requests.

For example, you can submit the output ID you receive from our Convert to PDF tool to watermark your new PDF document.

See Documentation

Watermark Text

The watermark_text parameter lets you submit text to add as a watermark into your document.

The following parameters allow you to further adjust your text watermark:

font - set the font of your text watermark
text_size - set the font size
text_color_rgb or text_color_cmyk - set text color
opacity - set text opacity
x and y - horizontal and vertical offset, respectively
rotation - apply rotation to your text watermark

See Documentation

Watermark File

The watermark_file parameter lets you upload a PDF to pdfRest's processing server to be added as a watermark to your input document.

To add an image file as a watermark to a PDF, you can use pdfRest's Convert to PDF tool to convert a JPG, PNG, TIF, or BMP file to PDF and submit it here using the watermark_file or watermark_file_id parameter.

The following parameters allow you to further adjust your file watermark:

watermark_file_scale - apply a size multiplier to your file watermark
opacity - set watermark opacity
x and y - horizontal and vertical offset, respectively, from the center of the page
rotation - apply rotation to your watermark

See Documentation

Watermark File Id

The watermark_file_id parameter allows you to submit a resource ID generated by one of our API Tools. The file associated with the resource ID will be applied to your input document as a PDF watermark.

The following parameters allow you to further adjust your file watermark:

watermark_file_scale - apply a size multiplier to your file watermark
opacity - set watermark opacity
x and y - horizontal and vertical offset, respectively, from the center of the page
rotation - apply rotation to your watermark

See Documentation

Text Size

The text_size parameter lets you specify the font size of a text watermark from 5 to 100.

See Documentation

Output

The output parameter lets you set a filename (without extension) for your watermarked PDF.

See Documentation

Font

The font parameter lets you set the font of your text watermark.

See our Font List for a complete list of fonts supported by pdfRest.

See Documentation

Text Color RGB

The text_color_rgb parameter lets you specify a color for your text watermark using the RGB color model.

Cannot be combined with the text_color_cmyk parameter.

See Documentation

Text Color CMYK

The text_color_cmyk lets you select a color for your text watermark using the CMYK color model.

Cannot be combined with the text_color_rgb parameter.

See Documentation

Watermark File Scale

The watermark_file_scale parameter lets you resize the content of a PDF watermark file.

See Documentation

Opacity

The opacity parameter lets you set the opacity of your text or file watermark using a decimal value from 0.0 (fully transparent) to 1.0 (fully opaque).

See Documentation

The x parameter lets you set a horizontal offset from the center of the page for your watermark. Offset values use PDF units (72 units = 1 inch).

See Documentation

The y parameter lets you set a vertical offset from the center of the page for your watermark. Offset values use PDF units (72 units = 1 inch).

See Documentation

Rotation

The rotation parameter lets you apply a rotation (in degrees) to your text or file watermark.

See Documentation