PDFera API Reference

Authentication

All API requests require authentication via your API key. Include your key in the Authorization header of every request.

Authorization: Bearer YOUR_API_KEY

Convert to PDF

POST/v1/convert

Request Parameters

{
    "file": "string (required)",
    "format": "word|excel|image",
    "options": {
      "quality": "low|medium|high",
      "ocr": "boolean"
    }
  }

Example Request

curl -X POST https://api.pdfera.com/v1/convert \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@document.docx" \
-F "format=word"

Response

{
    "id": "conv_12345",
    "status": "processing",
    "download_url": "https://...",
    "expires_at": "2023-08-20T12:00:00Z"
  }

Error Handling

{
    "error": {
      "code": "invalid_api_key",
      "message": "Invalid API key provided"
    }
  }

Common Error Codes

  • 400 - Bad Request
  • 401 - Unauthorized
  • 429 - Rate Limit Exceeded
  • 500 - Internal Server Error

Rate Limits

  • 100 requests per minute
  • 5 concurrent conversions
  • 50MB maximum file size