API Documentation

Welcome to the ConvertIntoMP4 API! Our REST API allows you to convert files between formats programmatically. The API uses a task-based architecture where each operation (import, convert, export) is a task that can be combined into jobs for complex workflows.

Base URL

https://api.convertintomp4.com/v1

Request Format

• All requests must include Content-Type: application/json header
• All requests must include authentication via Bearer token
• Request bodies should be valid JSON

Response Format

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-02-15T10:30:00Z"
  }
}

Most conversion endpoints work without authentication (anonymous users get 5 conversions/day). Authenticated users get higher quotas based on their plan. API keys can be created in your dashboard at https://convertintomp4.com/account/api.

API Key Header

Include your API key in the X-Api-Key header:

curl https://api.convertintomp4.com/v1/jobs \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

You can also use Authorization: Bearer YOUR_API_KEY as an alternative.

API Scopes

Step 1: Get Your API Key

Sign up at convertintomp4.com/register and create an API key in your dashboard.

Step 2: Make Your First Conversion

Create a job that imports a file from URL, converts it, and exports a download link:

# Simple file conversion (recommended for most use cases)
curl -X POST https://api.convertintomp4.com/v1/convert \
  -H "X-Api-Key: ck_your_api_key" \
  -F "[email protected]" \
  -F "targetFormat=mp4" \
  -F "quality=high" \
  -F "codec=h264"

# Advanced: Multi-step job pipeline (import -> convert -> export)
curl -X POST https://api.convertintomp4.com/v1/jobs \
  -H "X-Api-Key: ck_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "tasks": {
      "import-file": {
        "operation": "import/url",
        "url": "https://example.com/video.mov"
      },
      "convert-file": {
        "operation": "convert",
        "input": "import-file",
        "output_format": "mp4",
        "options": { "quality": "high" }
      },
      "export-file": {
        "operation": "export/url",
        "input": "convert-file"
      }
    }
  }'

Step 3: Check Job Status

curl https://api.convertintomp4.com/v1/jobs/job_abc123def456 \
  -H "X-Api-Key: ck_your_api_key"

Step 4: Download the Result

Once complete, the export task contains a download URL:

{
  "tasks": {
    "export-file": {
      "status": "completed",
      "result": {
        "url": "https://files.convertintomp4.com/abc123/output.mp4",
        "expires_at": "2026-02-16T10:30:00Z"
      }
    }
  }
}

A dedicated sandbox environment for risk-free testing is planned but not yet available. In the meantime, you can test with the production API using the free tier (5 conversions/day, no API key required).

Production base URL: https://api.convertintomp4.com/v1

Dedicated endpoints for advanced PDF processing. All PDF operations are also available as task types within jobs.

Available Operations

Example: OCR a PDF

curl -X POST https://api.convertintomp4.com/v1/pdf/ocr \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "https://example.com/scanned-doc.pdf",
    "language": "eng",
    "output_format": "pdf-searchable"
  }'

Example: Merge PDFs

{
  "files": [
    "https://example.com/part1.pdf",
    "https://example.com/part2.pdf",
    "https://example.com/part3.pdf"
  ],
  "output_filename": "merged.pdf"
}

Example: Encrypt PDF

{
  "file": "https://example.com/document.pdf",
  "password": "secure-password-123",
  "permissions": {
    "printing": true,
    "copying": false,
    "modifying": false
  }
}

Import and export files directly from your cloud storage providers. We support Amazon S3, Azure Blob Storage, Google Cloud Storage, and SFTP.

Supported Providers

Azure Blob Storage

{
  "operation": "import/azure",
  "storage_account": "myaccount",
  "container": "my-container",
  "blob": "path/to/file.mp4",
  "sas_token": "sv=2023-01-03&st=...&sig=..."
}

Google Cloud Storage

{
  "operation": "import/gcs",
  "bucket": "my-bucket",
  "project_id": "my-project-id",
  "key": "path/to/file.mp4",
  "credentials": {
    "type": "service_account",
    "project_id": "my-project-id",
    "private_key": "..."
  }
}

SFTP

{
  "operation": "import/sftp",
  "host": "sftp.example.com",
  "port": 22,
  "username": "user",
  "private_key": "-----BEGIN RSA PRIVATE KEY-----...",
  "path": "/uploads/video.mp4"
}

Crop video frames or trim audio/video to specific time ranges. Available as task operations within jobs.

Video Crop

Crop the video frame to a specific region:

{
  "operation": "crop",
  "input": "import-task",
  "options": {
    "x": 100,
    "y": 50,
    "width": 1280,
    "height": 720
  }
}

Crop Options

Audio/Video Trim

Trim media to a specific time range:

{
  "operation": "trim",
  "input": "import-task",
  "options": {
    "start_time": "00:01:30",
    "end_time": "00:05:00"
  }
}

Trim Options

Query which formats are supported for each operation. Useful for building dynamic UIs that show available conversions.

Query by Operation

GET /v1/formats/query/convert
GET /v1/formats/query/compress
GET /v1/formats/query/crop
GET /v1/formats/query/trim
GET /v1/formats/query/merge

Response

{
  "success": true,
  "data": [
    {
      "name": "mp4",
      "category": "video",
      "targets": ["mov", "avi", "mkv", "webm", "gif"]
    },
    {
      "name": "jpg",
      "category": "image",
      "targets": ["png", "webp", "gif", "bmp", "tiff"]
    }
  ]
}

Import our complete API collection into Postman for interactive testing. The collection includes all endpoints with pre-configured example requests and environment variables.

Collection Variables

The official Node.js/TypeScript SDK is available on npm. Additional SDKs for other languages are in development. In the meantime, use the REST API directly with any HTTP client. See the cURL and language examples above.

Best Practices

• Always handle errors - Wrap API calls in try/catch blocks
• Use webhooks - Avoid polling when possible
• Implement retry logic - Handle rate limits with exponential backoff
• Store API keys securely - Never commit API keys to version control