Developer REST API
Programmatically generate high-speed direct download links, monitor quota telemetry, and integrate ExtreamLeech with JDownloader2, custom download managers, and server pipelines.
Authentication & Security
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:
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
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. |