API Documentation

import requests

with open("photo.jpg", "rb") as f:
    res = requests.post(
        "https://api.apiwatermark.com/watermark",
        headers={"Authorization": "Bearer aw_••••••••"},
        files={"image": f},
        data={
            "type": "text",
            "text": "© 2026 MyBrand",
            "position": "bottom-right",
            "opacity": "0.5",
            "font_size": "24",
            "output_format": "webp",
        },
    )

with open("watermarked.webp", "wb") as f:
    f.write(res.content)

Authorization: Bearer aw_••••••••••••••••

curl -X POST https://api.apiwatermark.com/watermark \
  -H "Authorization: Bearer aw_••••••••" \
  -F "image=@photo.jpg" \
  -F "type=text" \
  -F "text=© 2026 MyBrand" \
  -F "position=bottom-right" \
  -F "opacity=0.5" \
  -F "font_size=24" \
  -F "output_format=webp" \
  -o watermarked.webp

curl -X POST https://api.apiwatermark.com/watermark \
  -H "Authorization: Bearer aw_••••••••" \
  -F "image=@photo.jpg" \
  -F "type=image" \
  -F "watermark_image=@logo.png" \
  -F "position=center" \
  -F "opacity=0.3" \
  -F "watermark_width=200" \
  -o branded.jpg

curl -X POST https://api.apiwatermark.com/watermark \
  -H "Authorization: Bearer aw_••••••••" \
  -F "image=@photo.jpg" \
  -F "type=text" \
  -F "text=DRAFT" \
  -F "position=tiled" \
  -F "opacity=0.15" \
  -F "rotation=-30" \
  -F "tile_gap=120" \
  -F "tile_angle=-30" \
  -F "font_size=48" \
  -F "color=#ff0000" \
  -o draft.png

# Source PDF is auto-detected — output is always PDF.
# Every page receives the same watermark.
curl -X POST https://api.apiwatermark.com/watermark \
  -H "Authorization: Bearer aw_••••••••" \
  -F "image=@contract.pdf" \
  -F "type=text" \
  -F "text=CONFIDENTIAL · {{email}}" \
  -F "position=tiled" \
  -F "opacity=0.15" \
  -o stamped.pdf

curl -X POST https://api.apiwatermark.com/watermark/batch \
  -H "Authorization: Bearer aw_••••••••" \
  -F "images[]=@photo-1.jpg" \
  -F "images[]=@photo-2.jpg" \
  -F "images[]=@photo-3.jpg" \
  -F "type=text" \
  -F "text=© 2026 MyBrand" \
  -F "position=bottom-right" \
  -o watermarked-batch.zip

# Up to 20 files per request · 100 MB total · returns a ZIP.
# Mix images and PDFs freely — outputs keep their source extension.

# 1. Get a presigned R2 upload URL
PRESIGN=$(curl -s -X POST https://api.apiwatermark.com/upload/presign \
  -H "Content-Type: application/json" \
  -d '{"contentType":"video/mp4","fileName":"clip.mp4","fileSize":125000000}')
R2_KEY=$(echo "$PRESIGN" | jq -r .key)
UPLOAD_URL=$(echo "$PRESIGN" | jq -r .uploadUrl)

# 2. PUT the source video to R2
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary @clip.mp4

# 3. Create the asynchronous video job
JOB=$(curl -s -X POST https://api.apiwatermark.com/video/watermark \
  -H "Authorization: Bearer aw_••••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceR2Key": "'$R2_KEY'",
    "sourceFileName": "clip.mp4",
    "sourceFileSize": 125000000,
    "outputFormat": "mp4",
    "watermarkConfig": {
      "type": "text",
      "text": "© {{email}}",
      "fontSize": 32,
      "color": "#ffffff",
      "position": "bottom-right",
      "opacity": 0.5
    }
  }')
JOB_ID=$(echo "$JOB" | jq -r .jobId)

# 4. Poll status (2-5s intervals are fine; polling is free)
while true; do
  STATUS=$(curl -s -H "Authorization: Bearer aw_••••••••" \
    https://api.apiwatermark.com/video/watermark/$JOB_ID)
  STATE=$(echo "$STATUS" | jq -r .status)
  echo "[$STATE] $(echo "$STATUS" | jq -r .progress)%"
  case "$STATE" in
    completed) echo "$STATUS" | jq -r .downloadUrl; break ;;
    failed)    echo "$STATUS" | jq -r .error >&2; exit 1 ;;
  esac
  sleep 3
done

# 5. (Shortcut) Skip steps 4 with ?download=1 — redirects to the asset URL
curl -L -H "Authorization: Bearer aw_••••••••" \
  "https://api.apiwatermark.com/video/watermark/$JOB_ID?download=1" -o watermarked.mp4

# 1. Ask for a presigned upload URL
PRESIGN=$(curl -s -X POST https://api.apiwatermark.com/upload/presign \
  -H "Content-Type: application/json" \
  -d '{"contentType":"image/jpeg","fileName":"large.jpg","fileSize":15000000}')
UPLOAD_URL=$(echo "$PRESIGN" | jq -r .uploadUrl)
R2_KEY=$(echo "$PRESIGN" | jq -r .key)

# 2. PUT the file directly to Cloudflare R2 (bypasses Vercel body limits)
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @large.jpg

# 3. Process the uploaded R2 object
curl -X POST https://api.apiwatermark.com/watermark \
  -H "Authorization: Bearer aw_••••••••" \
  -F "r2_key=$R2_KEY" \
  -F "type=text" \
  -F "text=© MyBrand" \
  -F "position=bottom-right" \
  -o watermarked.jpg

# Alternative for small files (< 4.5 MB on Vercel)
curl -X POST https://api.apiwatermark.com/upload/direct \
  -F "file=@photo.jpg"
# Response: { "key": "uploads/uuid.jpg" }

{
  "error": "Missing required field: image (or r2_key for R2 uploads)"
}

// For 500 errors:
{
  "error": "Failed to process watermark",
  "details": "Input image exceeds pixel limit"
}

curl https://apiwatermark.com/api/openapi.json | jq .