API Documentation

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

curl -X POST https://api.masterconverter.com/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf" \
  -F "target_format=docx" \
  -F "quality=high"

import requests

url = "https://api.masterconverter.com/v1/convert"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

files = {
    "file": open("document.pdf", "rb"),
    "target_format": (None, "docx"),
    "quality": (None, "high")
}

response = requests.post(url, headers=headers, files=files)
result = response.json()

print(f"Job ID: {result['job_id']}")
print(f"Status: {result['status']}")

# Check status
status_url = f"https://api.masterconverter.com/v1/status/{result['job_id']}"
status_response = requests.get(status_url, headers=headers)
status_result = status_response.json()

if status_result['status'] == 'completed':
    download_url = f"https://api.masterconverter.com/v1/download/{result['job_id']}"
    download_response = requests.get(download_url, headers=headers)
    
    with open("converted_document.docx", "wb") as f:
        f.write(download_response.content)

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

async function convertFile() {
    const form = new FormData();
    form.append('file', fs.createReadStream('document.pdf'));
    form.append('target_format', 'docx');
    form.append('quality', 'high');

    try {
        const response = await axios.post(
            'https://api.masterconverter.com/v1/convert',
            form,
            {
                headers: {
                    'Authorization': 'Bearer YOUR_API_KEY',
                    ...form.getHeaders()
                }
            }
        );

        const jobId = response.data.job_id;
        console.log(`Job ID: ${jobId}`);

        // Poll for completion
        let status = 'processing';
        while (status === 'processing') {
            await new Promise(resolve => setTimeout(resolve, 2000));
            
            const statusResponse = await axios.get(
                `https://api.masterconverter.com/v1/status/${jobId}`,
                {
                    headers: {
                        'Authorization': 'Bearer YOUR_API_KEY'
                    }
                }
            );
            
            status = statusResponse.data.status;
            console.log(`Status: ${status}`);
        }

        if (status === 'completed') {
            const downloadResponse = await axios.get(
                `https://api.masterconverter.com/v1/download/${jobId}`,
                {
                    headers: {
                        'Authorization': 'Bearer YOUR_API_KEY'
                    },
                    responseType: 'stream'
                }
            );

            const writer = fs.createWriteStream('converted_document.docx');
            downloadResponse.data.pipe(writer);
            
            writer.on('finish', () => {
                console.log('File downloaded successfully!');
            });
        }
    } catch (error) {
        console.error('Error:', error.response.data);
    }
}

convertFile();

 new CURLFile('document.pdf'),
    'target_format' => 'docx',
    'quality' => 'high'
];

curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$response = curl_exec($ch);
$result = json_decode($response, true);

echo "Job ID: " . $result['job_id'] . "\n";

// Check status
$statusCh = curl_init();
curl_setopt($statusCh, CURLOPT_URL, 'https://api.masterconverter.com/v1/status/' . $result['job_id']);
curl_setopt($statusCh, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($statusCh, CURLOPT_RETURNTRANSFER, 1);

do {
    sleep(2);
    $statusResponse = curl_exec($statusCh);
    $statusResult = json_decode($statusResponse, true);
    echo "Status: " . $statusResult['status'] . "\n";
} while ($statusResult['status'] === 'processing');

if ($statusResult['status'] === 'completed') {
    $downloadCh = curl_init();
    curl_setopt($downloadCh, CURLOPT_URL, 'https://api.masterconverter.com/v1/download/' . $result['job_id']);
    curl_setopt($downloadCh, CURLOPT_HTTPHEADER, [
        'Authorization: Bearer YOUR_API_KEY'
    ]);
    curl_setopt($downloadCh, CURLOPT_RETURNTRANSFER, 1);
    
    $fileContent = curl_exec($downloadCh);
    file_put_contents('converted_document.docx', $fileContent);
    
    echo "File downloaded successfully!\n";
    curl_close($downloadCh);
}

curl_close($ch);
curl_close($statusCh);
?>

{
  "file": "document.pdf",
  "target_format": "docx",
  "webhook_url": "https://your-app.com/webhook/conversion-complete"
}

{
  "event": "conversion.completed",
  "job_id": "job_12345",
  "status": "completed",
  "original_filename": "document.pdf",
  "target_format": "docx",
  "file_size": 2048576,
  "processing_time": 15.5,
  "download_url": "https://api.masterconverter.com/v1/download/job_12345",
  "expires_at": "2025-11-04T12:00:00Z",
  "timestamp": "2025-11-03T12:00:00Z"
}

X-MasterConverter-Signature: sha256=signature_hash

X-RateLimit-Limit: 50
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1699027200

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Please wait before retrying.",
  "retry_after": 60
}

{
  "error": "invalid_format",
  "message": "The specified target format is not supported for this file type.",
  "code": "FORMAT_NOT_SUPPORTED",
  "details": {
    "supported_formats": ["pdf", "docx", "txt"]
  }
}