REST API

YumPDF API

Upload and process files with our simple REST API. No authentication required — get instant download links with automatic cleanup.

Rate Limits
100
Requests / min
500 MB
Max file size
1 hour
Auto-delete

Features

No Authentication
Just POST your file. No API key or account needed.
Instant Links
Get download links immediately after upload.
Auto Cleanup
Files are automatically deleted after 1 hour.
Download Options
Users can download locally or save to Google Drive.

Endpoints

Description

Upload a file for processing. The file is stored securely and a download link is returned. Files are automatically deleted after 1 hour.

Parameters
filefileRequired

The file to process (max 500MB)

methodstring

Processing method e.g. "merge", "convert", "compress"

Example Request
curl -X POST https://yumpdf.com/api/process \
  -F "file=@document.pdf" \
  -F "method=compress"
Example Response
{
  "status": "ok",
  "data": {
    "downloadLink": "https://gofile.io/d/x7k2p9Qm",
    "fileId": "d4c5e6f7-a8b9-4c0d-9e1f-2a3b4c5d6e7f",
    "shareCode": "Qp9w8eR7",
    "expiresAt": 1754512800000,
    "fileName": "document.pdf",
    "fileSize": 2481621
  }
}

Error Handling

400
error-field

Validation error — missing required field

413
error-limits

File size exceeds maximum limit (500 MB)

429
error-rateLimit

Rate limit exceeded (100 req / min)

500
error-internal

Internal server error

Integration Examples

JavaScript / Node.js
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('method', 'compress');

const response = await fetch('/api/process', {
  method: 'POST',
  body: formData
});

const result = await response.json();
console.log(result.data.downloadLink);
Python
import requests

with open('document.pdf', 'rb') as f:
    files = {'file': f}
    data = {'method': 'compress'}

    response = requests.post(
        'https://yumpdf.com/api/process',
        files=files,
        data=data
    )

print(response.json()['data']['downloadLink'])
cURL
curl -X POST https://yumpdf.com/api/process \
  -F "file=@document.pdf" \
  -F "method=compress"

Need help? Visit YumPDF