---
id: cloudconvert
version: "2.1.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# cloudconvert — Python REST API wrapper for cloud convert

License: permissive · Maintenance: aging · Downloads: 434.1K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 434.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cloudconvert api python sdk, file conversion api wrapper, document format conversion, cloud file conversion service, rest api file converter, batch file conversion, import export file tasks, file-conversion, rest-api-client, cloud-service

[View on SkillFed](https://skillfed.io/packages/cloudconvert) · [View on PyPI](https://pypi.org/project/cloudconvert/)