Watermark Tools
Overlay Watermark PDF API Overview
Use a PDF page as an overlay watermark across target PDFs for branding and background graphics. Select the source PDF overlay file and page, control scale and opacity, and position the overlay on each page. Apply to specific pages or ranges, set a watermark style, and add interactive actions such as external links or go‑to page navigation. Respect page rotation and place the overlay precisely for consistent, professional results across batches and automated workflows.
PDF Overlay Watermarking
Overlay one PDF onto another to add letterheads, stamps, headers, footers, or templates without altering layout or quality.
Layered PDF Watermark Control
Apply watermark PDFs as foreground or background layers without modifying the original PDF content.
Pixel-Perfect Alignment
Ensure precise scaling, positioning, and alignment between source and watermark PDFs for professional layouts.
High-Performance PDF Processing
Overlay PDFs in seconds with scalable cloud processing, optimized for single files or high-volume batch workflows.
Customizable Parameters
Fine-tune your automation with these powerful conversion options
File
File Supported formats: .pdfFile to be converted. Value can be URL or file content.
Password
StringSets the password to open protected documents.
PageRange
String Default: 1-2000Set page range. Example 1-10 or 1,2,5.
OverlayFile
File Supported formats: .pdfSpecifies the PDF file to use as overlay. Value can be URL or file content.
OverlayPage
Integer Default: 1Specifies the page to use as overlay from the OverlayFile file.
Range: 1 .. 2000Scale
Integer Default: 100Specifies the watermark scale in percent.
Range: 0 .. 2000Opacity
Integer Default: 100Specifies watermark opacity level.
Range: 0 .. 100Style
Collection Default: watermarkSpecifies watermark style, stamp or watermark. The stamp is placed over page content and watermark under page content.
Values: stamp watermarkGoToLink
StringSpecifies the web address to go when the watermark is clicked.
GoToPage
StringSpecifies the page number to go when the watermark is clicked.
PageRotation
Bool Default: FalseSpecifies whether the watermark should respect the PDF page rotation. When enabled, the watermark is rotated together with the page. When disabled, the watermark is placed ignoring page rotation.
PageBox
Collection Default: mediaboxSpecifies the PDF page box used as the reference area for applying the watermark.
Values: mediabox trimbox bleedbox cropboxMeasurementUnit
Collection Default: ptMeasurement unit for position and size parameters.
Values: pt in mm cmOffsetX
DoubleSpecifies the watermark offset along the X-axis. Positive values move the watermark to the right, while negative values move it to the left, using the selected MeasurementUnit.
OffsetY
DoubleSpecifies the watermark offset along the Y-axis. Positive values move the watermark downward, while negative values move it upward, using the selected MeasurementUnit.
HorizontalAlignment
Collection Default: centerSpecifies the horizontal watermark alignment.
Values: left center rightVerticalAlignment
Collection Default: centerSpecifies the vertical watermark alignment.
Values: top center bottomStoreFile
Bool Default: FalseWhen the StoreFile parameter is set to True, your converted file is written to ConvertAPI’s encrypted, temporary storage and made available via a time-limited secure download URL, valid for up to 3 hours. After this period, the file is permanently deleted.
When StoreFile is set to False, conversion happens entirely in-memory. The raw file bytes are streamed back in the API response without touching disk or external storage, ensuring maximum security and zero persistence so that only you can access the content.
Integrate within minutes
Easy Overlay Watermark PDF automation using our simple REST-API
Businesses trust us
Highest rated File Conversion API on major B2B software listing platforms: Capterra, G2, and Trustpilot.
"ConvertAPI has been a game-changer for our document automation workflows. Their conversion accuracy and API reliability are unmatched in the industry for over 7 years."
"ConvertAPI is a reliable, cost-effective solution with a proven track record of stability. It has grown significantly in maturity, adopting enterprise-grade practices over the years."
"We've integrated ConvertAPI across our entire document processing platform. The performance is exceptional and the support team is always responsive. Highly recommended!"
Enterprise-Grade Security
We ensure that all document processing is handled securely in the cloud, adhering to industry-leading standards like ISO 27001, GDPR, and HIPAA. To enhance security even further, we can ensure that no files or data are stored on our servers and never leave your country.
Learn more about security