Media Downloader API

1. Obtain Your API Key

Send a POST request to /register_api_user with your email and phone:

POST /register_api_user HTTP/1.1
Content-Type: application/x-www-form-urlencoded

email=user@example.com&phone=+1234567890

Successful response:

{
  "success": true,
  "email": "user@example.com",
  "api_key": "YOUR-NEW-API-KEY"
}

2. Get Available Formats

Use your API key to fetch formats for a given media URL:

GET /api/v1/formats?url=https://www.youtube.com/watch?v=abc123 HTTP/1.1
X-API-Key: YOUR-API-KEY
Accept: application/json

Example curl command:

curl -G \
  -H "X-API-Key: YOUR-API-KEY" \
  --data-urlencode "url=https://youtu.be/abc123" \
  https://your-domain.com/api/v1/formats

Successful response:

{
  "success": true,
  "data": {
    "title": "Video Title",
    "original_url": "https://youtu.be/abc123",
    "formats": [
      {
        "format_id": "18",
        "ext": "mp4",
        "resolution": "360p",
        "filesize": 1024000,
        "filesize_display": "1.0 MB",
        "type": "Video+Audio",
        "url": "https://..."
      },
      // ... more formats
    ]
  }
}

Error Handling

Errors return success: false and an error message, e.g.:

{
  "success": false,
  "error": "Unsupported URL."
}