cloudconvert

What it is and what it does

cloudconvert is the official Python wrapper for CloudConvert's file conversion API. It abstracts the REST API into Python objects and methods, letting you create conversion jobs, upload files, download results, and verify webhook signatures without manually constructing HTTP requests. The SDK handles job creation with task-based payloads (import, convert, export operations), file uploads via multipart forms, and result retrieval through public URLs.

The package is lightweight, depending only on requests and urllib3 for HTTP transport. It's designed for server-side automation—batch document conversions, format migrations, or integration into larger workflows—where you need to programmatically trigger CloudConvert's cloud infrastructure rather than use their web interface. Configuration is simple: set an API key and call methods like Job.create(), Task.wait(), or Task.upload().

Use it for:

• Batch convert documents (PDF to Word, images to PDF) in a backend service without manual CloudConvert dashboard interaction
• Build a file conversion microservice that accepts uploads and returns converted files via CloudConvert's infrastructure
• Automate webhook signature verification to securely process job completion notifications from CloudConvert
• Generate signed URLs for on-demand file conversion using only URL parameters, enabling client-side conversion requests
• Integrate file format conversion into a data pipeline or ETL workflow that processes multiple file types

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Official Python SDK for CloudConvert API v2, enabling programmatic file conversion, upload, download, and job management through REST API calls.

Yes, if you need CloudConvert's conversion service and want official SDK support. The package is permissively licensed, has low install friction, and carries no known vulnerabilities. However, note that it has not been updated since 2022—verify compatibility with your Python version and current CloudConvert API v2 behavior before relying on it for production. The aging status suggests you should monitor the repository for updates or consider whether the API has evolved beyond the SDK's current implementation.

Install

cloudconvert on PyPI

pip install cloudconvert

uv add cloudconvert

poetry add cloudconvert

Installing cloudconvert

Before you install

Low install friction with only requests and urllib3 as dependencies. Package is aging (last release 2022-03-30, 1598 days ago) but repository remains active with recent commits and no archived status.

License in practice

MIT license (permissive) allows commercial and private use with minimal restrictions.

Quickstart

pip install cloudconvert

import cloudconvert

cloudconvert.configure(api_key='YOUR_API_KEY')
job = cloudconvert.Job.create(payload={
    'tasks': {
        'convert-file': {
            'operation': 'convert',
            'input_format': 'pdf',
            'output_format': 'docx'
        }
    }
})

Requires a valid CloudConvert API key from https://cloudconvert.com/api/v2

Verify before relying

• Whether the package supports modern Python versions (3.10+) despite unspecified python_support
• Current status of CloudConvert API v2 endpoint stability and backwards compatibility
• Whether the aging codebase has known compatibility issues with recent requests or urllib3 versions

Package facts

Evidence: cloudconvert-2.1.0-py3-none-any.whl

Tags

More WWW/HTTP packages