Name: watermark-pdf
Price: 0.02 USDC
Availability: InStock

$ man watermark-pdf

agentutility / mediakit / watermark-pdf

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

mediakit

CATEGORY

uncategorized

STATUS

● live

NAME

watermark-pdf — add watermark to pdf

synonym alias of watermark — reuses the canonical handler.

SYNOPSIS

POST https://x402.org/v1/watermark-pdf
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Add watermark to PDF. Text or image overlay on PDFs, PNG / JPG / GIF, or MP4 / MOV / WEBM with configurable position, opacity, font, rotation, and margin. Same backend as watermark / pdf-watermark under a clearer search slug. CloudConvert engine.

INPUT — request schema

property	type	description	req?
file_url	string	URL of the PDF, image, or video file to watermark.	required
text	string	Watermark text to overlay on the file; mutually exclusive with image_url.	optional
image_url	string	URL of an image to use as the watermark overlay; mutually exclusive with text.	optional
font_size	number	Font size in points for text watermarks.	optional
font_color	string	Hex color code (e.g., #FF0000) for the watermark text.	optional
opacity	number	Watermark opacity from 0 (transparent) to 1 (fully opaque).	optional
rotation	number	Rotation angle in degrees applied to the watermark.	optional
position_vertical	string	Vertical placement of the watermark: top, center, or bottom. enum: top · center · bottom	optional
position_horizontal	string	Horizontal placement of the watermark: left, center, or right. enum: left · center · right	optional

OUTPUT — response shape

field	type	description
output_url	string	URL of the watermarked PDF, image, or video file.
watermark_type	string	Type of watermark applied: text or image.
input_format	string	Detected format of the source file (pdf, png, jpg, gif, mp4, mov, or webm).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/watermark-pdf \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the watermark-pdf tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: mediakitpdfwatermarkpdf-watermarkoverlaycloudconvertadd-watermark-pdf
methods: POST
cluster: mediakit
price: $0.02 USDC per call

ADJACENT — other endpoints in mediakit

endpoint	description	price
audio-loudnorm	Audio loudness normalizer (EBU R128 LUFS).	$0.02
csv-to-jsonl	CSV to JSON / CSV to JSONL converter / data pipeline preprocessor.	$0.02
image-translate	Image translator: vision-OCR + Venice translate.	$0.02
image-upscale	Image upscale / 2x upscaler / 4x upscaler / super-resolution / sharpen image / enlarge image without loss.	$0.02
pdf-watermark	PDF watermark / image watermark / video watermark — text or image overlay on PDFs, PNG/JPG/GIF, or MP4/MOV/WEBM.	$0.02
video-to-subtitles	SRT / VTT subtitle generator from video or audio.	$0.02
video-trim	Video trimmer / video cutter / video clip tool.	$0.02
watermark	PDF / image / video watermarking — text or image overlay.	$0.02

/watermark-pdf(1)