PL

Playlet API

Playlet is a short drama streaming platform with Aliyun Private DRM encryption. This API provides access to Playlet content with client-side DRM decryption support, CDN-direct TS segments for zero server bandwidth, 12 subtitle languages, and 11 content languages.

Get Started Endpoints
▶
Client-Side DRM
Aliyun Private AES-128-ECB
🔓
Zero Bandwidth
CDN-direct TS segments
🌐
11 Languages
ID, EN, CN, TW, TH, VI, PT, ES, FR, AR, MS
Authentication

All Playlet 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/playlet/trending

Supported Languages

Loading...
Endpoints
GET /api/playlet/languages API Key
Returns list of supported languages with codes and names.
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/languages"
GET /api/playlet/trending API Key
Returns currently trending dramas on Playlet.
ParameterTypeDescription
langoptionalstringLanguage code (default: id)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/trending?lang=en"
GET /api/playlet/foryou API Key
Browse the full Playlet drama catalog with pagination. Returns 20 items per page from a background-crawled catalog (~200+ dramas, refreshed every 30 min).
ParameterTypeDescription
pageoptionalintegerPage number (default: 1)
langoptionalstringLanguage code (default: id)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/foryou?page=1&lang=id"
GET /api/playlet/search?q={query} API Key
Search for dramas within Playlet. Supports pagination.
ParameterTypeDescription
qrequiredstringSearch query
pageoptionalintegerPage number (default: 1)
langoptionalstringLanguage code (default: id)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/search?q=love&lang=en"
GET /api/playlet/detail?id={theater_id} API Key
Get detailed information about a specific Playlet drama including all episodes with metadata, subtitle availability, and video quality options.
ParameterTypeDescription
idrequiredstringDrama ID (theater_id) from search or trending results
langoptionalstringLanguage code (default: id)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/detail?id=10744&lang=en"
GET /api/playlet/allepisode?id={theater_id} API Key
Returns all episodes for a drama in a single call, including video URLs, subtitles, and lock status. Same data as detail but semantically indicates you want the full episode list.
ParameterTypeDescription
idrequiredstringDrama ID (theater_id) from search or trending results
langoptionalstringLanguage code (default: id)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/allepisode?id=10744&lang=en"
GET /api/playlet/episode?id={id}&ep={ep} API Key
Get video URL and metadata for a specific episode. Returns the HLS master playlist URL and available quality options.
ParameterTypeDescription
idrequiredstringDrama ID (theater_id)
eprequiredintegerEpisode number
langoptionalstringLanguage code (default: id)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/episode?id=10744&ep=1&lang=en"
GET /api/playlet/playinfo?id={id}&ep={ep} API Key
Returns DRM decryption key and CDN segment URLs for client-side playback. The key field contains a hex-encoded AES-128-ECB key for decrypting TS segments (null for clear streams). segments is an array of CDN-direct URLs — build an m3u8 client-side for zero server bandwidth.
ParameterTypeDescription
idrequiredstringDrama ID (theater_id)
eprequiredintegerEpisode number
qoptionalstringQuality: ld (360p), sd (480p), hd (720p). Default: hd
langoptionalstringLanguage code (default: id)
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/playinfo?id=10744&ep=1&q=hd&lang=en"
GET /api/playlet/subtitles?id={id}&ep={ep}&lang={lang} API Key
Fetch subtitles for a specific episode in the requested language. Returns SRT-format subtitle text converted to a structured array with timestamps and text.
ParameterTypeDescription
idrequiredstringDrama ID (theater_id)
eprequiredstringEpisode number (or chapter_id)
langoptionalstringSubtitle language code (default: same as content lang). Available: ID, EN, CN, TW, TH, VI, PT, ES, FR, AR, MS, OFF
Example
curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/subtitles?id=10744&ep=1&lang=en"
GET /api/playlet/hls?id={id}&ep={ep} API Key
Redirects (302) to the CDN m3u8 stream. Use the hlsUrl from the detail/allepisode/episode response — do not construct manually. Note: streams are DRM-encrypted (Aliyun Private AES-128-ECB); use the playinfo endpoint for client-side decryption keys.
ParameterTypeDescription
idrequiredstringDrama ID (theater_id)
eprequiredintegerEpisode number
langoptionalstringLanguage code (default: id)
Example
curl -L -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/playlet/hls?id=10744&ep=1&lang=en"
Playlet — Api-Dracin Multi-Source Drama Streaming API