DB

DramaBox API

DramaBox is one of the most popular short drama apps globally, featuring thousands of bite-sized drama series across romance, thriller, fantasy, and more. This API provides access to DramaBox content with HLS streaming, 16 language support, and all episodes unlocked — TS segments served directly from CDN with zero server bandwidth.

Get Started Endpoints
▶
HLS Streaming
Synthetic m3u8 + CDN TS
🔓
All Episodes Unlocked
Web SSR bypass
🌐
Multi-Language
Hardsub multi-language
Authentication

All DramaBox endpoints require the X-API-Key header except /health and /api/sources.

Rate Limits

PlanRequests / min
Free10
Monthly5,000
LifetimeUnlimited

Example Request

curl -H "X-API-Key: YOUR_KEY" \
{{BASE}}/api/dramabox/trending

Supported Languages

Loading...
Endpoints
GET /api/dramabox/languages API Key
Returns list of supported languages with codes and names.
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/languages"
GET /api/dramabox/trending API Key
Returns currently trending dramas on DramaBox.
ParameterTypeDescription
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/trending?lang=en"
GET /api/dramabox/hotrank?type=1 API Key
Hot ranking lists — trending, top searched, and new releases.
ParameterTypeDescription
typeoptionalintegerRank type: 1 = trending, 2 = top searched, 3 = new releases (default: 1)
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/hotrank?type=1&lang=en"
GET /api/dramabox/recommended?page=1 API Key
Infinite recommendation feed — curated drama suggestions with pagination.
ParameterTypeDescription
pageoptionalintegerPage number (default: 1)
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/recommended?page=1&lang=en"
GET /api/dramabox/browse?page=1 API Key
Catalog browser — browse all dramas with pagination (30 items per page).
ParameterTypeDescription
pageoptionalintegerPage number (default: 1)
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/browse?page=1&lang=en"
GET /api/dramabox/categories API Key
Returns available genre/category filter options for the browse endpoint.
ParameterTypeDescription
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/categories?lang=en"
GET /api/dramabox/foryou?page=1 API Key
Personalized drama recommendations with pagination.
ParameterTypeDescription
pageoptionalintegerPage number (default: 1)
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/foryou?page=1&lang=en"
GET /api/dramabox/search?q={query} API Key
Search for dramas within DramaBox.
ParameterTypeDescription
qrequiredstringSearch query
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/search?q=love&lang=en"
GET /api/dramabox/detail?id={bookId} API Key
Get detailed information about a specific DramaBox drama.
ParameterTypeDescription
idrequiredstringBook ID from search or trending results
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/detail?id=42000004952&lang=en"
GET /api/dramabox/allepisode?id={bookId} API Key
Returns all episodes with HLS video URLs, subtitle endpoint URLs, and metadata. Each episode includes: number, chapterId, chapterName, hlsUrl (requires API key), subtitlesUrl (per-episode subtitle tracks endpoint), duration, locked (always false).
ParameterTypeDescription
idrequiredstringBook ID
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/allepisode?id=42000004952&lang=en"
GET /api/dramabox/subtitles?id={bookId}&ep={number} API Key
Returns available subtitle tracks (VTT) for a specific episode. Each track includes a language code and direct VTT URL.
ParameterTypeDescription
idrequiredstringBook ID
eprequiredintegerEpisode number
langoptionalstringLanguage code (default: en)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/subtitles?id=42000004952&ep=1"
GET /api/dramabox/hls?id=...&ep=... API Key
Returns a synthetic HLS m3u8 playlist. TS segments are served directly from CDN (zero server bandwidth). Requires API key authentication. Use the hlsUrl from the allepisode response.
ParameterTypeDescription
idrequiredstringBook ID
eprequiredintegerEpisode number
api_keyoptionalstringAPI key (alternative to X-API-Key header)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/dramabox/hls?id=42000004952&ep=1"
DramaBox — Api-Dracin Multi-Source Drama Streaming API