Docs/Get Started

Get Started

Start converting PDFs to editable PPTX in just a few minutes.

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/v1/convert"
files = {"file": open("presentation.pdf", "rb")}
headers = {"Authorization": "Bearer pk_xxxxxxxxxxxxx"}

response = requests.post(url, files=files, headers=headers)
task_id = response.json()["task_id"]
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/v1/tasks/{task_id}",
        headers=headers
    ).json()
    
    if status["status"] == "completed":
        print(f"Download: {status['download_url']}")
        break
    elif status["status"] == "failed":
        print(f"Error: {status['error']}")
        break
    
    time.sleep(2)