Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
DramaBos API — One unified REST API for 42 Chinese Drama & Short Drama platforms. 100K+ titles, 8M+ episodes, 40+ languages, HLS streaming via CDN.
Saved setup from 11 h ago
Will it work on macOS?
Also: Docs ↗
docs/getting-started.mdDramaBos API is a unified REST API that gives developers access to 42 short drama and Chinese drama platforms through a single integration. With 100,000+ drama titles, 8M+ episodes, and support for 40+ languages, DramaBos is the most comprehensive drama API available.
Visit dramabos.live/register to create your free account. You'll receive an API key immediately after registration.
Include your API key in the Authorization header of every request:
Authorization: Bearer YOUR_API_KEY
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://dramabos.live/dramabox/api/v1/search?keyword=love"
Response:
[
{
"id": "2047",
"title": "Stolen Destiny",
"cover": "https://cdn.dramabos.live/video/dramabox/covers/2047.jpg",
"episodes": 60,
"genre": "Mystery",
"source": "dramabox"
}
]
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://dramabos.live/dramabox/api/v1/detail/2047"
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://dramabos.live/dramabox/api/v1/episodes/2047"
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://dramabos.live/dramabox/api/v1/download/2047"
Response:
{
"dramaId": "2047",
"episode": 1,
"hlsUrl": "https://cdn.dramabos.live/video/dramabox/hls/2047/ep1/master.m3u8",
"quality": [
{ "definition": "1080p", "url": "https://cdn.dramabos.live/video/dramabox/hls/2047/ep1/1080p.m3u8" },
{ "definition": "720p", "url": "https://cdn.dramabos.live/video/dramabox/hls/2047/ep1/720p.m3u8" },
{ "definition": "480p", "url": "https://cdn.dramabos.live/video/dramabox/hls/2047/ep1/480p.m3u8" }
],
"duration": 95,
"source": "dramabox"
}
All API calls go through:
https://dramabos.live/{provider}/api/v1/{endpoint}
All media assets are served through:
https://cdn.dramabos.live/video/{provider}/
| Plan | Requests/Month | Rate Limit | |------|----------------|------------| | Free | 1,000 | Standard | | Basic | 100,000 | Higher | | Pro | 1,000,000 | Priority | | 3 Months | 100M/mo | Priority | | 1 Year | 100M/mo | Priority |
Register at dramabos.live/register to get your free API key.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://dramabos.live/dramabox/api/v1/search?keyword=love"
[
{
"id": "2047",
"title": "Stolen Destiny",
"cover": "https://cdn.dramabos.live/video/dramabox/covers/2047.jpg",
"episodes": 60,
"genre": "Mystery",
"source": "dramabox"
}
]
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/dramabosapi/dramabos-api.git cd dramabos-api
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://dramabos.live/dramabox/api/v1/search?keyword=love"
No reports for macOS yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.