Search, browse, and download drama episodes from multiple providers through one unified REST API. Built for developers.
Get up and running in minutes. Register for a free API key, then start making requests.
Create an account via POST /auth/register or contact admin for a higher-tier account. You'll receive an API token — save it immediately, it's shown only once.
Include your token in every request header:Authorization: Bearer mk_xxxxxxxxxxxxxxx
Use GET /v1/search with a provider and keyword to find dramas. Check GET /v1/providers to see which providers are available.
Fetch episode info with GET /v1/drama/{provider}/{bookId}/episodes/{ep}. The processed MP4 is served at the downloadUrl included in the response.
Choose the method that fits your integration.
Register to get a mk_ prefixed token. Send it as a Bearer token in the Authorization header. Best for server-to-server integrations.
curl -H "Authorization: Bearer mk_abc123..." \
https://your-host/v1/providers
Subscribe on RapidAPI to get automatic authentication via proxy headers. No token management needed — RapidAPI handles it.
Login via POST /auth/login to get a session token (ses_ prefix). Used by the admin panel. Expires after 24 hours.
Base URL: https://your-host — all responses are JSON unless noted.
Returns the list of drama providers currently configured and available on the server.
{
"providers": ["dramabox", "storyreel", "dramawave"]
}
| Name | Type | Required | Description |
|---|---|---|---|
provider | string | required | Provider name (e.g. dramabox) |
keyword | string | required | Search keyword (1–200 chars) |
page | int | optional | Page number (default: 1) |
{
"provider": "dramabox",
"movies": [
{
"bookId": "123456",
"bookName": "Love in the Moonlight",
"coverUrl": "https://cdn.example.com/cover.jpg",
"introduction": "A romantic drama about...",
"chapterCount": 80,
"source": "dramabox"
}
],
"page": 1,
"hasMore": true
}
| Name | Type | Required | Description |
|---|---|---|---|
provider | string | required | Provider name |
book_id | string | required | Drama ID (numeric or alphanumeric) |
{
"provider": "dramabox",
"bookId": "123456",
"bookName": "Love in the Moonlight",
"coverUrl": "https://cdn.example.com/cover.jpg",
"introduction": "A romantic drama about...",
"chapterCount": 80,
"episodes": [
{
"episode": 1,
"chapterId": "78901",
"chapterName": "EP 1",
"thumbnailUrl": "https://cdn.example.com/ep1.jpg",
"locked": false
}
]
}
| Name | Type | Required | Description |
|---|---|---|---|
provider | string | required | Provider name |
book_id | string | required | Drama ID |
episode | int | required | Episode number (≥ 1) |
{
"provider": "dramabox",
"episode": 1,
"chapterId": "78901",
"chapterName": "EP 1",
"thumbnailUrl": "https://cdn.example.com/ep1.jpg",
"locked": false,
"downloadUrl": "/v1/videos/dramabox/123456/1",
"fileSize": 15728640,
"movie": {
"bookId": "123456",
"bookName": "Love in the Moonlight"
}
}
// FREE tier: episodes 1–5 only, no download
// BASIC+: all episodes, full download access
| Name | Type | Required | Description |
|---|---|---|---|
provider | string | required | Provider name |
book_id | string | required | Drama ID |
episode | int | required | Episode number |
Returns video/mp4 file directly, or 302 Redirect to CloudFront/S3 presigned URL when S3 storage is enabled. Call GET .../episodes/{ep} first to trigger processing.
| Status | Reason |
|---|---|
403 | FREE tier — download not allowed |
404 | Video not processed yet |
| Field | Type | Required | Description |
|---|---|---|---|
email | string | required | Valid email address |
password | string | required | Min 8 characters |
display_name | string | optional | Display name |
curl -X POST https://your-host/auth/register \
-H "Content-Type: application/json" \
-d '{
"email": "dev@example.com",
"password": "securepass123",
"display_name": "John"
}'
{
"user_id": "a1b2c3d4-...",
"email": "dev@example.com",
"tier": "FREE",
"token": "mk_abc123def456...",
"message": "Save this token — it cannot be shown again."
}
// ⚠ The token is shown ONCE. Store it securely.
| Field | Type | Required | Description |
|---|---|---|---|
email | string | required | Registered email |
password | string | required | Account password |
{
"user_id": "a1b2c3d4-...",
"email": "dev@example.com",
"display_name": "John",
"role": "user",
"tier": "FREE",
"session_token": "ses_abc123..."
}
All errors return JSON with an error field.
| Status | Meaning | Action |
|---|---|---|
400 | Provider not available | Check /v1/providers |
401 | Missing or invalid credentials | Check your token or register |
403 | Tier restriction | Upgrade tier or contact admin |
404 | Not found | Check IDs / process episode first |
409 | Email already registered | Login instead or use another email |
422 | Validation error | Check request params |
429 | Rate limit exceeded | Wait and retry (see Retry-After header) |
502 | Upstream provider error | Retry later or try another provider |
New registrations start at FREE. Contact admin to upgrade.
Create a free account to start using the API immediately.