Conversion API

Seamlessly convert PDFs and other documents to various formats like Word, Excel, images, and more with our powerful API.

Conversion API Overview
Transform documents effortlessly with robust conversion capabilities

The Conversion API enables developers to convert PDFs and other document formats to a wide range of output formats, including Word, Excel, PowerPoint, images, and text. It supports password-protected PDFs, OCR for text extraction, and customizable quality settings for image outputs.

Endpoint

POST https://mega-pdf.com/api/convert

Authentication

Authenticate requests using an API key in the x-api-key header or as a query parameter (api_key).

// Header example
x-api-key: your-api-key

// Query parameter example
https://mega-pdf.com/api/convert?api_key=your-api-key

Supported Formats

The API supports the following input and output formats:

Input Formats
  • PDF (.pdf)
  • Word (.docx)
  • Excel (.xlsx, .xls)
  • PowerPoint (.pptx)
  • Rich Text Format (.rtf)
  • Plain Text (.txt)
  • HTML (.html)
  • Images (.jpg, .jpeg, .png)
Output Formats
  • PDF (.pdf)
  • Word (.docx)
  • Excel (.xlsx, .xls)
  • PowerPoint (.pptx)
  • Rich Text Format (.rtf)
  • Plain Text (.txt)
  • HTML (.html)
  • Images (.jpg, .jpeg, .png)

Request Parameters

The API accepts multipart/form-data requests with the following parameters:

ParameterTypeDescriptionRequired
fileFileThe input file to convertYes
inputFormatStringInput file format (optional if detectable from file extension)No
outputFormatStringDesired output formatYes
ocrBooleanEnable OCR for text extraction (for PDF to TXT)No
qualityNumberImage quality (1-100) for image outputsNo (default: 90)
passwordStringPassword for encrypted PDFsNo

Example Request

Convert a PDF to DOCX using cURL:

curl -X POST https://mega-pdf.com/api/convert \
  -H "x-api-key: your-api-key" \
  -F "file=@/path/to/document.pdf" \
  -F "outputFormat=docx"

Response Format

Successful responses include the converted file URL and metadata:

{
  "success": true,
  "message": "Conversion successful",
  "fileUrl": "/api/file?folder=conversions&filename=uuid-output.docx",
  "filename": "uuid-output.docx",
  "originalName": "document.pdf",
  "inputFormat": "pdf",
  "outputFormat": "docx"
}

Error responses:

{
  "success": false,
  "error": "Invalid or unsupported output format"
}

Code Examples

Using the Conversion API with JavaScript (Node.js):

const formData = new FormData();
formData.append('file', fs.createReadStream('document.pdf'));
formData.append('outputFormat', 'docx');

fetch('https://mega-pdf.com/api/convert', {
  method: 'POST',
  headers: {
    'x-api-key': 'your-api-key'
  },
  body: formData
})
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('Conversion successful:', data.fileUrl);
    } else {
      console.error('Conversion failed:', data.error);
    }
  })
  .catch(error => console.error('Error:', error));