Watermark Tools
Overlay Watermark PDF Python 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.
Lightning Fast Conversions
Process and convert files in seconds with our high-performance cloud infrastructure.
Accuracy Guaranteed
Our advanced algorithms ensure pixel-perfect and content-accurate file conversions.
Enterprise-Grade Security
ISO 27001, HIPAA, and GDPR compliant with encrypted file processing.
Global Infrastructure
Strategically located servers ensure low latency and high availability worldwide.
Developer Friendly
Comprehensive SDKs and clear documentation for quick and simple integration.
Time-Saving Automation
Automate repetitive document workflows and focus on what matters most.
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.
Step-by-Step Guide
Easy Overlay Watermark PDF integration programmatically using our Python library
1. ConvertAPI Python library install
ConvertAPI provides a Python library that allows you to perform a Overlay Watermark PDF conversion with just a few lines of code. Overlay Watermark PDF documents using Python SDK with no effort at all!
Install with pip:
pip install --upgrade convertapi
2. Authenticate your Python library
You can obtain your API Token by signing up for a free account. Once you sign up, you'll receive 250 free conversions instantly! Grab your API Token from the account dashboard, and authenticate the ConvertAPI Python library like this:
# get your API Token here: https://www.convertapi.com/a/auth
import convertapi
convertapi.api_credentials = 'api_token'
3. Overlay Watermark PDF using Python in no time!
Once you have your authentication in place, simply copy-paste this pdf to pdf-watermark conversion code snippet into your Python project:
Integrate within minutes
Easy Overlay Watermark PDF automation using our simple Python SDK
Compatible With all Python Frameworks & Tools
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