Authentication & Security

Active VIP Subscription Required: Developer REST API Keys can only be created and authenticated by accounts with an active VIP subscription. Free registered accounts cannot use the API.

All API requests must be transmitted securely over HTTPS. Authenticate calls by supplying your personal API token in the HTTP Authorization header as a Bearer token:

Authorization: Bearer ext_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Never expose your secret API key in client-side front-end code, public GitHub repositories, or browser scripts.

POST /api/v1/generate

Convert any supported premium file-host link (Rapidgator, 1fichier, KatFile, etc.) into an instant, high-speed direct download link.

Request Body (application/json)

Field Type Required Description
url string Required Target file host link (e.g. https://rapidgator.net/file/123/sample.zip)

Code Integration Examples

curl -X POST https://extreamleech.com/api/v1/generate \
  -H "Authorization: Bearer ext_YOUR_SECRET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://rapidgator.net/file/12345/archive.zip"}'

Success Response (HTTP 200 OK)

{
  "status": "success",
  "data": {
    "download_url": "https://direct-cdn.extreamleech.com/storage/file_archive.zip?token=8a3f...",
    "filename": "archive.zip",
    "filesize": 1572864000,
    "filesize_formatted": "1.46 GB",
    "host": "Rapidgator",
    "host_slug": "rapidgator",
    "provider": "Extream FastEngine Prime",
    "expires_at": "2026-09-24 20:30:00",
    "generation_time_ms": 284
  }
}

POST /api/v1/bulk-generate VIP ONLY

Process and unrestrict up to 5 file-host links simultaneously in a single request. Strictly reserved for active VIP members and Admin API keys.

Request Body (application/json)

Field Type Required Description
urls array of strings Required Array of 1 to 5 file-host URLs to process simultaneously

Example cURL Request

curl -X POST https://extreamleech.com/api/v1/bulk-generate \
  -H "Authorization: Bearer ext_YOUR_SECRET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://rapidgator.net/file/101/episode1.mkv",
      "https://rapidgator.net/file/102/episode2.mkv",
      "https://1fichier.com/?abcdef12345"
    ]
  }'

Success Response (HTTP 200 OK)

{
  "success": true,
  "total": 3,
  "successful": 3,
  "failed": 0,
  "was_trimmed": false,
  "items": [
    {
      "url": "https://rapidgator.net/file/101/episode1.mkv",
      "success": true,
      "data": {
        "download_url": "https://direct-cdn.extreamleech.com/storage/episode1.mkv?token=...",
        "filename": "episode1.mkv",
        "filesize": 850000000,
        "filesize_formatted": "810 MB",
        "host_name": "Rapidgator"
      },
      "error": null
    }
  ]
}

GET /api/v1/user

Retrieve the authenticated account profile, active VIP subscription status, daily quota ceiling, and remaining downloads today.

Code Example (Python)

import requests

headers = {"Authorization": "Bearer ext_YOUR_SECRET_API_KEY"}
response = requests.get("https://extreamleech.com/api/v1/user", headers=headers)
print(response.json())

Success Response (HTTP 200 OK)

{
  "status": "success",
  "data": {
    "user": {
      "id": 42,
      "name": "Jane Downloader",
      "email": "[email protected]",
      "role": "user",
      "status": "active"
    },
    "subscription": {
      "is_active": true,
      "plan_name": "Pro Unlimited",
      "expires_at": "2026-10-24 15:30:00",
      "daily_quota": 75
    },
    "quota": {
      "daily_limit": 75,
      "used_today": 12,
      "remaining": 63
    }
  }
}

GET /api/v1/hosts

List all active supported file hosts, matching domain patterns, and operational status. No authentication required.

curl -X GET https://extreamleech.com/api/v1/hosts

Success Response Excerpt (HTTP 200 OK)

{
  "status": "success",
  "data": {
    "total_hosts": 15,
    "hosts": [
      {
        "name": "Rapidgator",
        "slug": "rapidgator",
        "domains": ["rapidgator.net", "rg.to"],
        "status": "online",
        "daily_limit": 50,
        "max_file_size_bytes": 10737418240,
        "max_file_size": "10 GB"
      },
      {
        "name": "1fichier",
        "slug": "1fichier",
        "domains": ["1fichier.com", "alterupload.com"],
        "status": "online",
        "daily_limit": 100,
        "max_file_size_bytes": 53687091200,
        "max_file_size": "50 GB"
      }
    ]
  }
}

Standard API Error Codes

When an error occurs, ExtreamLeech returns standard HTTP error codes accompanied by an informative JSON body.

HTTP Status Error Code Description & Resolution
401 Unauthorized INVALID_API_KEY The API key provided is missing, expired, or has been revoked.
429 Rate Limit RATE_LIMIT_EXCEEDED Too many requests sent within 60 seconds. Check Retry-After header.
429 Limit QUOTA_EXCEEDED The account or guest IP has exhausted its daily link allowance.
400 Bad Request UNSUPPORTED_HOST The requested URL domain is not among our supported host list.
400 Bad Request HOST_OFFLINE The target file host is undergoing upstream maintenance.
403 Forbidden SSRF_BLOCKED The target IP/host resolves to private, loopback, or metadata addresses.
422 Unprocessable EMPTY_URL The required url parameter was missing from the request body.