How to use the CloudConvert API in Python

Online file converter for audio, video, document, ebook, archive, image, spreadsheet, presentation. This guide calls it from Python with code we've run against the live endpoint.

Online · 401 msEndpoint tested Oct 24, 2026

1. What you need

Python 3.8+ and the requests library: `pip install requests`.

An API key from the provider (apiKey authentication). Endpoint: https://cloudconvert.com/api/v2

2. Make the request

Python

import requests

res = requests.get("https://cloudconvert.com/api/v2", timeout=10)
res.raise_for_status()
data = res.json()
print(data)

3. The response

Trimmed from the live response on Oct 24, 2026.

JSON

{
  "redirect": "/docs"
}

4. Before you ship

Set a timeout and handle non-200 responses: free APIs can rate-limit or go down.
Cache responses where you can, instead of calling the API on every page view.
Keep the API key in an environment variable, never in source control.
Read the official documentation ↗ for rate limits and terms of use.

FAQ

Does the CloudConvert API need an API key in Python?

Yes. It uses apiKey authentication: read the key from an environment variable and send it with each request.

Can I call the CloudConvert API from the browser?

Not reliably: it doesn't send CORS headers. Call it from a server, serverless function or script.

What does the CloudConvert API return?

JSON. The example response on this page is trimmed from a real response our health check received on Oct 24, 2026.

Same API in: Node.js · PHP · Java · Go · Ruby · C#
CloudConvert API: ratings & reviews · CloudConvert API alternatives · more free APIs for Python