{"uid":"cap_tT3tG2ujiMLdVonxTnWsc","slug":"tanod-docs-pdf-watermark-c73482ff","name":"Tanod Docs PDF Watermark","description":"Documents: DOCX template fill, Office to PDF, any file to Markdown, PDF to Word, OCR, PDF pipeline.","url":"https://docs.tanod.dev/v1/pdf/watermark?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","maxLength":2048,"minLength":1},{"type":"null"}],"default":null,"description":"Public http(s) URL of the PDF (at most 20 MB; private, internal and IP-literal hosts are refused); or use pdf_base64."},"font":{"enum":["helvetica","helvetica-bold","times","times-bold","courier","courier-bold"],"type":"string","default":"helvetica-bold","description":"Built-in PDF font: helvetica, helvetica-bold (default), times, times-bold, courier or courier-bold."},"text":{"type":"string","maxLength":200,"minLength":1,"description":"Windows-1252 (Latin) text, drawn with a built-in PDF font."},"angle":{"type":"number","default":45,"maximum":360,"minimum":-360,"description":"Counter-clockwise degrees."},"color":{"type":"string","default":"#808080","pattern":"^#[0-9a-fA-F]{6}$","description":"Text colour as #rrggbb (default #808080, grey)."},"layer":{"enum":["over","under"],"type":"string","default":"over","description":"over (default: on top of the page content) or under (behind it; hidden where the page is opaque)."},"pages":{"anyOf":[{"type":"string","pattern":"^[0-9a-zA-Z ,\\-]+$","maxLength":200,"minLength":1},{"type":"null"}],"default":null,"description":"Pages to stamp (default all)."},"margin":{"type":"number","default":36,"maximum":144,"minimum":0,"description":"Points from the edge for non-center positions."},"output":{"enum":["base64","url"],"type":"string","default":"base64","description":"base64 (default): the file comes back inline as base64. url: the file is stored for 24 hours and the reply carries a download link (url, expires_at, bytes, content_type, sha256) instead of the base64, which keeps the file out of your context window."},"opacity":{"type":"number","default":0.3,"maximum":1,"minimum":0.05,"description":"0.05 (faint) to 1 (opaque); default 0.3."},"position":{"enum":["center","top-left","top-center","top-right","middle-left","middle-right","bottom-left","bottom-center","bottom-right"],"type":"string","default":"center","description":"center (default), top-left, top-center, top-right, middle-left, middle-right, bottom-left, bottom-center or bottom-right."},"font_size":{"type":"number","default":48,"maximum":300,"minimum":6,"description":"Points (6-300, default 48)."},"pdf_base64":{"anyOf":[{"type":"string","maxLength":13398872,"minLength":1},{"type":"null"}],"default":null,"description":"The PDF as base64 (at most 10 MB decoded per request); or use url."}}},"responseSchema":{"type":"json","example":{"file":{"name":"watermarked.pdf","bytes":13676,"pages":1,"data_base64":"JVBERi0xLjQKJb/3... (trimmed: 18,236 base64 characters in the reply)","content_type":"application/pdf"},"operation":"watermark","input_bytes":13264,"input_pages":1,"output_bytes":13676,"stamped_pages":1,"untrusted_content":true,"active_content_removed":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t71-HIcfVmeY4kABFlISf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stamps text watermarks onto PDF pages with configurable font, color, opacity, angle, position, and layer options","exampleAgentPrompt":"Can you watermark this PDF with the text 'CONFIDENTIAL' in red, at 50% opacity, diagonally at 45 degrees, centered on every page? The PDF is at https://example.com/report.pdf — return it as a base64 file.","exampleUseCases":[{"title":"Mark legal documents as draft","prompt":"Take this PDF contract at https://mybusiness.com/docs/contract_v1.pdf and stamp 'DRAFT' diagonally across every page in grey at 30% opacity using helvetica-bold font, on top of the content."},{"title":"Brand outgoing PDF reports","prompt":"Add a light watermark that says 'Acme Corp — Confidential' to this PDF — put it in the center of each page, angled at 45 degrees, in blue (#0000FF) at 20% opacity, and give me back a download link valid for 24 hours."},{"title":"Protect sensitive pages selectively","prompt":"I need to watermark only pages 1, 3, and 5 of this PDF at https://storage.example.com/sensitive_report.pdf with the text 'NOT FOR DISTRIBUTION' in red (#FF0000) at 60% opacity, positioned at the bottom-center, and return the result as base64."}],"resultDescription":"Returns a JSON object with the watermarked PDF either as an inline base64-encoded file (including name, byte size, page count, content_type) or as a temporary download URL valid for 24 hours (with url, expires_at, bytes, content_type, sha256). Also includes metadata: operation type, input byte size, input page count, output byte size, stamped page count, and a flag indicating if untrusted content was removed.","failureModes":["PDF URL is inaccessible, private, or exceeds 20 MB — returns error","PDF URL points to an internal/IP-literal host — refused for security","Watermark text exceeds 200 characters — validation error","Color value does not match #rrggbb hex pattern — validation error","Opacity outside 0.05–1 range — validation error","Neither url nor pdf_base64 provided — missing input error","Page range string contains invalid characters — validation error","Font value not in allowed enum — validation error"],"whenToPreferThis":"Choose this endpoint when you need to programmatically add text watermarks to PDFs with fine-grained control over font, color, opacity, angle, position, and which pages are stamped. It is ideal for marking documents as confidential, draft, or branded before distribution. Prefer this over general-purpose PDF editors when you need a pay-per-call API with no subscription, support for both URL-hosted and base64-encoded PDF inputs, and the option to receive output as either inline base64 or a short-lived download URL to keep responses compact.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:45:27.892Z","isFirstParty":false,"canonicalSlug":"tanod-docs-pdf-watermark-c73482ff"}