How to Compress PDFs via REST API — curl, Node.js & Python Examples

POST https://www.forgelab.africa/api/pdf/compress

curl -X POST https://www.forgelab.africa/api/pdf/compress \
  -H "X-API-Key: $FORGELAB_API_KEY" \
  -F "file=@report.pdf" \
  --output compressed.pdf

import fs from 'fs';
import fetch from 'node-fetch';
import FormData from 'form-data';

async function compressPdf(inputPath, outputPath) {
  const form = new FormData();
  form.append('file', fs.createReadStream(inputPath));

  const res = await fetch('https://www.forgelab.africa/api/pdf/compress', {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.FORGELAB_API_KEY,
      ...form.getHeaders(),
    },
    body: form,
  });

  if (!res.ok) throw new Error(`Compress failed: ${res.status}`);

  const buffer = await res.buffer();
  fs.writeFileSync(outputPath, buffer);
  console.log(`Saved: ${outputPath}`);
}

compressPdf('invoice.pdf', 'invoice-compressed.pdf');

import os
import requests

def compress_pdf(input_path: str, output_path: str) -> None:
    with open(input_path, "rb") as f:
        res = requests.post(
            "https://www.forgelab.africa/api/pdf/compress",
            headers={"X-API-Key": os.environ["FORGELAB_API_KEY"]},
            files={"file": f},
        )
    res.raise_for_status()
    with open(output_path, "wb") as out:
        out.write(res.content)
    print(f"Compressed PDF saved to {output_path}")

compress_pdf("report.pdf", "report-compressed.pdf")