Overview/Get Started

Start converting PDFs in minutes

Quick start guide for developers

01

Get your API Key

Create an API key from your dashboard. Keep it secure - you'll need it for all API requests.

python
# Your API key will look like this:
pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
02

Make your first request

Upload a PDF file and get back an editable PPTX. The conversion happens automatically.

python
import requests

url = "https://api.pdf.beauty/api/convert/submit"
files = {"file": open("presentation.pdf", "rb")}
headers = {"Authorization": "pk_xxxxxxxxxxxxx"}

response = requests.post(url, files=files, headers=headers)
task_id = response.json()["taskId"]
print(f"Task created: {task_id}")
03

Poll for completion

Check the task status until the conversion is complete. Then download your PPTX file.

python
import time

# Poll for task completion
while True:
    status = requests.get(
        f"https://api.pdf.beauty/api/convert/tasks/{task_id}",
        headers=headers
    ).json()
    
    if status["status"] == "completed":
        print(f"Download: {status['resultUrl']}")
        break
    elif status["status"] == "failed":
        print(f"Error: {status['error']}")
        break
    
    time.sleep(2)