Toolchi LogoToolchi
Back to Developer Portal

PDF Optimization & Watermark API

Programmatic execution of PDF merges, split-range extractions, size compressions, custom page number stamping, and copyright watermark injection.

POST /api/v1/pdf/share-ready

Query Parameters
pdf_urlsRequired • array

List of fully qualified HTTP links of PDF files to merge.

enable_watermarkOptional • boolean

If true, overlays copyright stamp footer on each page.

watermark_textOptional • string

Custom overlay watermark text stamp.

Example Response
{
  "success": true,
  "job_id": "pdf_job_948f2a",
  "merged_pages": 14,
  "output_size_bytes": 1050000,
  "download_url": "https://toolchi.online/files/merged-document.pdf",
  "share_readiness_score": 100
}
Integration Code Snippet
NodeJS / fetch request
const response = await fetch("https://toolchi.online/api/v1/pdf/share-ready", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer tc_live_xxxxxxxx"
  },
  body: JSON.stringify({
    pdf_urls: [
      "https://yoursite.com/invoices/inv01.pdf",
      "https://yoursite.com/invoices/inv02.pdf"
    ],
    enable_watermark: true,
    watermark_text: "Confidential - Toolchi API"
  })
});
const data = await response.json();
console.log("Merged PDF ready:", data.download_url);

Ready to automate PDF compiling workflows?

Generate a sandbox API key and run queries directly in your terminal.