Developer API Documentation
Integrate ultra-fast cloud video hosting, automated remote URL transfers, folder organization, and direct playback streams directly into your websites, bots, and automated pipelines.
Authentication
How to authorize API requests
You authenticate API requests by providing your private API Key. You can find or regenerate your API key at any time in your Account Settings.
Supported Authentication Methods
X-API-Key: dpe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Authorization: Bearer dpe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
https://dropembed.com/api/videos?api_key=dpe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Account Information
Retrieve your profile, storage usage, and subscription status
/api/account/info
curl -X GET https://dropembed.com/api/account/info -H "X-API-Key: YOUR_API_KEY"
{
"success": true,
"data": {
"id": 42,
"username": "creator_pro",
"email": "[email protected]",
"role": "user",
"balance": 184.50,
"premium": {
"is_premium": true,
"plan": "no_ads_90",
"expires_at": "2026-12-31T23:59:59.000Z"
},
"storage": {
"total_videos": 128,
"used_bytes": 14285714285,
"used_mb": 13623.92
},
"api_key": "dpe_live_a1b2c3d4e5f6...",
"created_at": "2026-01-15 10:30:00"
}
}
Direct Video Upload
Upload video files directly (up to 10 GB per file)
Send video files as multipart/form-data. Uploads are instantly queued for high-speed transcoding and CDN streaming.
https://upload.dropembed.com/api/videos/upload
https://dropembed.com/api/videos/upload (for files < 100MB) and https://upload.dropembed.com/api/videos/upload (up to 10GB) accept the exact same authentication and parameters.
https://upload.dropembed.com/api/videos/upload
| Field | Type | Required | Description |
|---|---|---|---|
| video | File | Yes | The video binary (MP4, MKV, AVI, WEBM, MOV, etc. Max 10 GB for Free accounts, Unlimited for Pro) |
| title | String | No | Video title (defaults to uploaded filename) |
| description | String | No | Optional text description |
| folder_id | Integer | No | Target folder ID in your dashboard |
curl -X POST https://upload.dropembed.com/api/videos/upload -H "X-API-Key: YOUR_API_KEY" -F "video=@/path/to/movie.mp4" -F "title=My Awesome Video"
{
"success": true,
"video_id": "bc5657ec-83f4-490f-aa97-c3a52c83f72b",
"title": "My Awesome Video",
"status": "processing",
"url": "https://dropembed.com/v/bc5657ec-83f4-490f-aa97-c3a52c83f72b",
"embed_url": "https://dropembed.com/v/bc5657ec-83f4-490f-aa97-c3a52c83f72b"
}
Remote URL Upload
Download videos from external HTTP/HTTPS direct links automatically
/api/videos/remote-upload
curl -X POST https://dropembed.com/api/videos/remote-upload -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{
"urls": [
"https://example.com/videos/episode1.mp4",
"https://example.com/videos/episode2.mp4"
]
}'
{
"success": true,
"message": "2 URL(s) queued for background download.",
"tasks": [
{
"video_id": "c1f721bc-341e-450a-9d3e-908127391823",
"title": "episode1",
"url": "https://example.com/videos/episode1.mp4",
"status": "downloading"
}
]
}
/api/videos/remote-tasks
Check the real-time download and encoding status of active remote tasks.
curl -X GET https://dropembed.com/api/videos/remote-tasks -H "X-API-Key: YOUR_API_KEY"
Video Management
List, inspect, update, and delete videos
/api/videos?page=1&limit=50&folder_id=
Lists your uploaded videos with pagination.
curl -X GET "https://dropembed.com/api/videos?page=1&limit=20" -H "X-API-Key: YOUR_API_KEY"
/api/videos/:id
Get full video metadata, thumbnail URL, views, and duration.
curl -X GET "https://dropembed.com/api/videos/bc5657ec-83f4-490f-aa97-c3a52c83f72b" -H "X-API-Key: YOUR_API_KEY"
/api/videos/:id/hls
Fetch a signed, player-independent direct HLS playlist URL (.m3u8) for custom video players (VLC, ExoPlayer, AVPlayer, custom web players) without requiring the Dropembed player or website embeds. Up to 4K Ultra HD (2160p) streaming quality supported.
curl -X GET "https://dropembed.com/api/videos/{VIDEO_ID}/hls" -H "X-API-Key: YOUR_API_KEY"
Example Response
{
"success": true,
"video_id": "bc5657ec-83f4-490f-aa97-c3a52c83f72b",
"title": "My 4K Ultra HD Stream",
"direct_hls_url": "https://vid.dropembed.com/bc5657ec.../playlist.m3u8?direct_token=...&expires=...",
"expires_at": "2026-10-02T21:00:00.000Z",
"expires_in_seconds": 86400,
"player_independent": true,
"max_resolution": "4K Ultra HD (2160p)"
}
/api/videos/:id
Update video title, description, or embed permissions.
curl -X PATCH "https://dropembed.com/api/videos/bc5657ec-83f4-490f-aa97-c3a52c83f72b" -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"title": "Updated Title", "allow_embed": 1, "is_public": 1}'
/api/videos/:id
Permanently delete a video and free up storage quota.
curl -X DELETE "https://dropembed.com/api/videos/bc5657ec-83f4-490f-aa97-c3a52c83f72b" -H "X-API-Key: YOUR_API_KEY"
Embed Formats & BBCode
Easily integrate into websites, forums, and blogs
https://dropembed.com/v/{VIDEO_ID}
<iframe src="https://dropembed.com/v/{VIDEO_ID}" width="100%" height="100%" frameborder="0" allowfullscreen allow="autoplay; fullscreen"></iframe>
[URL=https://dropembed.com/v/{VIDEO_ID}][IMG]https://vid.dropembed.com/{VIDEO_ID}/thumbnail.jpg[/IMG][/URL]
Earnings & Payouts
Programmatic access to your earnings balance
/api/earnings
Retrieve available balance, historical payouts, and views count.
curl -X GET https://dropembed.com/api/earnings -H "X-API-Key: YOUR_API_KEY"
/api/earnings/withdraw
Request a payout (min $15.00) via your registered payment address.
curl -X POST https://dropembed.com/api/earnings/withdraw -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"amount": 50.00, "address": "0x..."}'
HTTP Status Codes & Errors
Request succeeded.
Missing required parameters or invalid syntax.
Missing or invalid API key.
You do not have permission to access the requested resource.
Simultaneous upload limit reached or too many requests.
Internal server error. Please retry or contact support.