uvpdftool

The UV pdfTool API from Python 3.9 and later: compress, convert, OCR and check PDFs on UV pdfTool's servers. The standard library only; type hints included.

pip install uvpdftool

import os

from uvpdftool import Client, JobFailedError

client = Client(api_key=os.environ["UVPDF_KEY"])

# Creates the job, uploads the file, starts it and waits for it.
job = client.run(
    "compress",
    files=["report.pdf"],
    options={"method": "ghostscript", "preset": "ebook"},
)

for output in job.outputs:
    client.download(output, output.name)

Make a key on the API keys page; a test key is free and marks its results. Keep the key on your server, never in a browser or an app.

What it does

A file is a path, or (name, bytes, content_type), or (name, file_object, content_type, size). A refused request raises ApiError (status, code, message, details, retry_after); a job that fails or is cancelled raises JobFailedError (.job, with job.error).

The tools, their options and the errors are documented at https://uvpdftool.com/developers.