LeaflyPDF API

250 jobs/month free, then from €0.005/job · REST + webhooks · SDKs

OpenAPI reference · openapi.json · API keys

1. Create a job

curl -X POST https://api.leaflypdf.com/v1/jobs \
  -H "Authorization: Bearer $LEAFLYPDF_KEY" \
  -F tool=compress \
  -F 'options={"preset":"recommended"}' \
  -F file=@input.pdf

2. Poll or receive a webhook

curl https://api.leaflypdf.com/v1/jobs/$JOB_ID -H "Authorization: Bearer $LEAFLYPDF_KEY"
# webhook: POST with header LeaflyPDF-Signature: t=<ts>,v1=<hmac-sha256(secret, "<ts>.<body>")>

3. Download

curl -o out.pdf https://api.leaflypdf.com/v1/jobs/$JOB_ID/outputs/0 -H "Authorization: Bearer $LEAFLYPDF_KEY"

SDKs

npm i @pdfworks/sdk
import { PdfWorks } from '@pdfworks/sdk';
const pw = new PdfWorks({ apiKey: process.env.LEAFLYPDF_KEY });
const [out] = await pw.run('merge', [a, b]);

pip install pdfworks
from pdfworks import PdfWorks
PdfWorks(api_key=KEY).run("ocr", ["scan.pdf"], {"langs": ["deu"]})

Tools (68)