Watermark PDF API
Add text or image watermarks to PDFs programmatically. Protect confidential documents, lock in your brand, and prevent unauthorized distribution with custom watermarks on every page.
curl -X POST "https://api.xspdf.com/v1/manipulate/watermark" \
-H "Authorization: Bearer $API_KEY" \
-d '{"input_url":"https://files.example.com/doc.pdf","options":{"text":"CONFIDENTIAL","opacity":0.4,"rotation":45,"font_size":48}}'Unprotected PDFs leak everywhere
Confidential reports get forwarded without permission. Branded proposals lose your logo. Legal documents circulate without attribution. Manual watermarking wastes hours.
Manual watermarking is tedious
Open PDF, insert text box, position watermark, adjust opacity, repeat for every page. Got 100 contracts? That's an entire afternoon wasted.
No brand protection on proposals
Send a proposal without watermarks. Prospect forwards it to competitors. Your pricing and positioning leak. You lose the deal.
Confidential docs circulate freely
Legal drafts, financial reports, and internal memos get shared without watermarks. No traceability. No accountability. Security teams panic.
The hidden cost of no watermarking
Staff time spent manually watermarking: 8+ hours/week. Lost deals from leaked proposals: 5-10% of pipeline. Security breaches from untraced documents: Priceless risk.
Add watermarks in 290ms. Protect everything.
290ms average watermark time
Upload PDF URL, specify text or image watermark. Control opacity, rotation, position, and font. Apply to all pages or specific ranges. Batch process thousands without clicking.
Customizable text and image watermarks
Add text like "CONFIDENTIAL" or "DRAFT". Upload logo images. Set color, size, transparency. Rotate 45 degrees for classic diagonal look. Position anywhere on the page.
Enterprise-grade security
SOC 2 certified. Files encrypted at rest and in transit. Auto-deleted after 24 hours. GDPR compliant with EU data residency options.
500 operations free every month. No credit card required. See FAQ
import requests
API_KEY = "your_api_key"
response = requests.post(
"https://api.xspdf.com/v1/manipulate/watermark",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"input_url": "https://files.example.com/doc.pdf",
"options": {
"text": "CONFIDENTIAL",
"opacity": 0.4,
"rotation": 45,
"font_size": 48
}
}
)
watermarked_url = response.json()["output_url"]
print(f"Watermarked PDF: {watermarked_url}")Built for security and branding workflows
Everything you need to watermark, brand, and protect PDFs at scale.
Text or image watermarks
Add text watermarks like "CONFIDENTIAL" or "DRAFT". Upload logo images for branding. Mix both on same document.
Full opacity and rotation control
Set transparency from 0-100%. Rotate to any angle. Classic 45-degree diagonal or horizontal/vertical. Your design, your rules.
Precise positioning options
Center, top-left, bottom-right, or custom coordinates. Apply to header, footer, or center of page. Perfect alignment every time.
Per-page or all-page application
Apply watermark to all pages, specific page ranges, or alternating pages. Perfect for mixed documents with public and confidential sections.
Webhook notifications
Get notified when watermark operation completes. Perfect for async workflows and batch processing pipelines.
Auto-expiring CDN URLs
Files served from global CDN with optional expiration. Download or stream directly. Full control over retention policies.
Frequently asked questions
Can I use my company logo as a watermark?
Yes. Upload your logo as a PNG or JPG, specify position and opacity. We support transparent PNGs for clean overlay on any background.
You can also combine text and image watermarks. For example, add your logo in the corner and "CONFIDENTIAL" diagonally across the page.
Can people remove the watermark?
Watermarks are embedded into the PDF content layer. They can't be removed by simply selecting and deleting. However, determined users with PDF editing tools could potentially remove them.
For stronger protection, combine watermarks with password encryption using our Protect PDF API. This prevents unauthorized editing entirely.
How fast is the watermark process?
Median watermark time is 290ms for standard documents. Very large PDFs (500+ pages) may take 1-2 seconds.
All requests are processed in real-time. Use webhooks for async workflows if you need to watermark thousands of documents without blocking.
Do you store my PDF files permanently?
No. Input PDFs and output files are automatically deleted after 24 hours. You can configure shorter retention periods or request immediate deletion after download.
All files are encrypted at rest and in transit. We're SOC 2 certified and GDPR compliant. Enterprise plans include custom retention policies and private storage regions.
What SDKs and languages do you support?
Official SDKs for Python, Node.js, Ruby, PHP, Go, and Java. REST API works with any language that can make HTTP requests.
All SDKs include TypeScript support, automatic retries, and built-in error handling. Check our docs for code examples and integration guides.
Start watermarking PDFs in 5 minutes
500 free operations every month. No credit card required. Scale to millions with transparent pricing.