Dropembed

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.

Base Endpoint
https://dropembed.com
Authentication
X-API-Key Header
Response Format
JSON (UTF-8)

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

1. Custom Header (Recommended)
Fastest
X-API-Key: dpe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
2. Authorization Bearer Header
Authorization: Bearer dpe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. URL Query Parameter
https://dropembed.com/api/videos?api_key=dpe_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Account Information

Retrieve your profile, storage usage, and subscription status

GET /api/account/info
Example cURL Request
curl -X GET https://dropembed.com/api/account/info   -H "X-API-Key: YOUR_API_KEY"
Sample Response (200 OK)
{
  "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.

Large Files (> 100 MB): To upload videos up to 10 GB without Cloudflare proxy body-size restrictions (HTTP 413), use our direct upload endpoint:
https://upload.dropembed.com/api/videos/upload
Both 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.
POST https://upload.dropembed.com/api/videos/upload
Parameters (Form-Data)
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
Example cURL Request (Direct Multi-GB Upload)
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"
Sample Response (200 OK)
{
  "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

POST /api/videos/remote-upload
Example cURL Request (Submit Links)
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"
    ]
  }'
Sample Response (200 OK)
{
  "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"
    }
  ]
}
GET /api/videos/remote-tasks

Check the real-time download and encoding status of active remote tasks.

cURL Request
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

GET /api/videos?page=1&limit=50&folder_id=

Lists your uploaded videos with pagination.

cURL Request
curl -X GET "https://dropembed.com/api/videos?page=1&limit=20"   -H "X-API-Key: YOUR_API_KEY"
GET /api/videos/:id

Get full video metadata, thumbnail URL, views, and duration.

cURL Request
curl -X GET "https://dropembed.com/api/videos/bc5657ec-83f4-490f-aa97-c3a52c83f72b"   -H "X-API-Key: YOUR_API_KEY"
GET /api/videos/:id/hls
Premium

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.

Security Requirement: You can only retrieve direct HLS streams for your own uploaded videos.
cURL Request
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)"
}
PATCH /api/videos/:id

Update video title, description, or embed permissions.

cURL Request
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}'
DELETE /api/videos/:id

Permanently delete a video and free up storage quota.

cURL Request
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

Direct Player URL
https://dropembed.com/v/{VIDEO_ID}
Responsive HTML iFrame Code
<iframe src="https://dropembed.com/v/{VIDEO_ID}" width="100%" height="100%" frameborder="0" allowfullscreen allow="autoplay; fullscreen"></iframe>
Code for Forums (BBCode with Thumbnail)
[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

GET /api/earnings

Retrieve available balance, historical payouts, and views count.

cURL Request
curl -X GET https://dropembed.com/api/earnings   -H "X-API-Key: YOUR_API_KEY"
POST /api/earnings/withdraw

Request a payout (min $15.00) via your registered payment address.

cURL Request
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

200 OK

Request succeeded.

400 Bad Request

Missing required parameters or invalid syntax.

401 Unauthorized

Missing or invalid API key.

403 Forbidden

You do not have permission to access the requested resource.

429 Rate Limited

Simultaneous upload limit reached or too many requests.

500 Server Error

Internal server error. Please retry or contact support.