Docs menu
DramaBox API endpoint
DramaBox Home Shelves API
Returns DramaBox's (dramabox.com) home page: the featured short dramas and the three curated shelves (Trending, Must-sees, Hidden gems), each title with its id, title, description, cover, DramaBox link, episode count, tags, genres and the view count as the site prints it. Use dramabox-more for a whole shelf. Only public catalog metadata is read; no playable video is returned.
GETapiKey3 credits/requestDramaBoxdramabox.homeResponseDoc
DramaBox/dramabox/homeEndpoint facts
- Method
- GET
- API path
- /dramabox/home
- Auth
- apiKey
- Credits
- 3 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- DramaBox
- Response schema
- #/definitions/dramabox.homeResponseDoc
How this endpoint behaves
Query parameters:
language: optional site locale:en,ko,zhHans,zh,es,ja,de,in(Indonesian),th,tl,pt,fr,arorit. Defaults toen. Titles, descriptions and tags are translated, and each locale has its own library.
Notable response behavior:
featuredholds the large promoted titles.shelvesholds the curated lists with aposition(trending,must-seesorhidden-gems) that you can pass todramabox-morefor the whole list.views_displayis the view count exactly as the site prints it (for example15.6K). It is not comparable withdramabox-drama'sviews, which is the title's lifetime count.- Playable video is never returned.
Example response (long values and lists shortened):
{
"code": 200,
"msg": "OK",
"data": {
"language": "en",
"featured": [
{
"id": "42000028173",
"title": "Love Is A Dangerous Game",
"description": "Olivia is dragged by her husband Ryan to a couples-swapping getaway—only to be paired with Jake, the husband o…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg",
"url": "https://www.dramabox.com/drama/42000028173/Love-Is-A-Dangerous-Game",
"episodes": 43,
"tags": [
"Billionaire",
"Forbidden Love"
],
"genres": [
{
"id": 258,
"name": "Billionaire"
},
{
"id": 583,
"name": "Forbidden Love"
}
],
"views_display": "15.6K",
"status": "Completed"
},
{
"id": "42000021382",
"title": "Deny Me, Dragon King",
"description": "Human Lyra stumbles on Dragon King Kael and shares a passionate night. Tricked by a fake prophecy, he casts he…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021382/42000021382.jpg",
"url": "https://www.dramabox.com/drama/42000021382/Deny-Me-Dragon-King",
"episodes": 50,
"tags": [
"Single Mom",
"Secret Baby"
],
"genres": [
{
"id": 161,
"name": "Romance"
}
],
"views_display": "17.4K",
"status": "Completed"
}
],
"shelves": [
{
"id": 1264,
"name": "Must-sees",
"position": "must-sees",
"books": [
{
"id": "42000024547",
"title": "My Billionaire Patient Is My Baby Daddy",
"description": "Ella is tricked by her divorce-seeking husband Arthur into sleeping with a stranger on their wedding night, an…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000024547/42000024547.jpg",
"url": "https://www.dramabox.com/drama/42000024547/My-Billionaire-Patient-Is-My-Baby-Daddy",
"episodes": 45,
"tags": [
"Billionaire",
"Hidden Identity"
],
"genres": [
{
"id": 161,
"name": "Romance"
}
],
"views_display": "15.9K",
"status": "Completed"
},
{
"id": "42000024553",
"title": "No More Blood For My Vampire First Love",
"description": "She gave him her heart, only to be used as a pawn to win her cruel stepsister. Shattered, the gifted Keeper Al…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000024553/42000024553.jpg",
"url": "https://www.dramabox.com/drama/42000024553/No-More-Blood-For-My-Vampire-First-Love",
"episodes": 54,
"tags": [
"Revenge",
"Love Triangle"
],
"genres": [
{
"id": 253,
"name": "Love Triangle"
}
],
"views_display": "19.4K",
"status": "Completed"
}
]
},
{
"id": 1265,
"name": "Trending",
"position": "trending",
"books": [
{
"id": "42000030998",
"title": "Falling for the Prince at Dark Arts Academy",
"description": "After demons slaughter her parents, Margo enters Edenfall Academy, an elite school ruled by the very creatures…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000030998/42000030998.jpg",
"url": "https://www.dramabox.com/drama/42000030998/Falling-for-the-Prince-at-Dark-Arts-Academy",
"episodes": 50,
"tags": [
"Forbidden Love",
"Hidden Identity"
],
"genres": [
{
"id": 161,
"name": "Romance"
}
],
"views_display": "19.0K",
"status": "Completed"
},
{
"id": "42000030307",
"title": "The Hidden Princess at the All-Alpha Academy",
"description": "One princess. Two fated mates. One secret that could ruin everything. Fleeing a sinister arranged marriage, Pr…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000030307/42000030307.jpg",
"url": "https://www.dramabox.com/drama/42000030307/The-Hidden-Princess-at-the-All-Alpha-Academy",
"episodes": 50,
"tags": [
"Reverse Harem",
"Werewolf"
],
"genres": [
{
"id": 161,
"name": "Romance"
},
{
"id": 248,
"name": "Sweet Love"
}
],
"views_display": "18.0K",
"status": "Completed"
}
]
}
]
}
}
Sampled response
- Request, 26 Oct 2026
- GET /dramabox/home
- Items in featured
- 3
- Fields filled in every checked item
- 10
| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| id | 3 | |
| title | 3 | “Love Is A Dangerous Game” and 2 other values |
| description | 3 | median 387 characters |
| cover_url | 3 | thwztchapter.dramaboxdb.com |
| url | 3 | dramabox.com |
| episodes | 3 | 43 to 58, median 50 |
| tags | 3 | median 2 entries |
| genres | 3 | median 1 entry |
| views_display | 3 | “15.6K” and 2 other values |
| status | 3 | “Completed” |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| language | string | No | en | Site locale, one of: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it (in is Indonesian); defaults to en. Each locale has its own title library Allowed values: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it. | ja |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/dramabox/home?language=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"language": "en",
"featured": [
{
"id": "42000028173",
"title": "Love Is A Dangerous Game",
"description": "Olivia is dragged by her husband Ryan to a couples-swapping getaway—only to be paired with Jake, the husband o…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg",
"url": "https://www.dramabox.com/drama/42000028173/Love-Is-A-Dangerous-Game",
"episodes": 43,
"tags": [
"Billionaire",
"Forbidden Love"
],
"genres": [
{
"id": 258,
"name": "Billionaire"
},
{
"id": 583,
"name": "Forbidden Love"
}
],
"views_display": "15.6K",
"status": "Completed"
},
{
"id": "42000021382",
"title": "Deny Me, Dragon King",
"description": "Human Lyra stumbles on Dragon King Kael and shares a passionate night. Tricked by a fake prophecy, he casts he…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021382/42000021382.jpg",
"url": "https://www.dramabox.com/drama/42000021382/Deny-Me-Dragon-King",
"episodes": 50,
"tags": [
"Single Mom",
"Secret Baby"
],
"genres": [
{
"id": 161,
"name": "Romance"
}
],
"views_display": "17.4K",
"status": "Completed"
}
],
"shelves": [
{
"id": 1264,
"name": "Must-sees",
"position": "must-sees",
"books": [
{
"id": "42000024547",
"title": "My Billionaire Patient Is My Baby Daddy",
"description": "Ella is tricked by her divorce-seeking husband Arthur into sleeping with a stranger on their wedding night, an…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000024547/42000024547.jpg",
"url": "https://www.dramabox.com/drama/42000024547/My-Billionaire-Patient-Is-My-Baby-Daddy",
"episodes": 45,
"tags": [
"Billionaire",
"Hidden Identity"
],
"genres": [
{
"id": 161,
"name": "Romance"
}
],
"views_display": "15.9K",
"status": "Completed"
},
{
"id": "42000024553",
"title": "No More Blood For My Vampire First Love",
"description": "She gave him her heart, only to be used as a pawn to win her cruel stepsister. Shattered, the gifted Keeper Al…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000024553/42000024553.jpg",
"url": "https://www.dramabox.com/drama/42000024553/No-More-Blood-For-My-Vampire-First-Love",
"episodes": 54,
"tags": [
"Revenge",
"Love Triangle"
],
"genres": [
{
"id": 253,
"name": "Love Triangle"
}
],
"views_display": "19.4K",
"status": "Completed"
}
]
},
{
"id": 1265,
"name": "Trending",
"position": "trending",
"books": [
{
"id": "42000030998",
"title": "Falling for the Prince at Dark Arts Academy",
"description": "After demons slaughter her parents, Margo enters Edenfall Academy, an elite school ruled by the very creatures…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000030998/42000030998.jpg",
"url": "https://www.dramabox.com/drama/42000030998/Falling-for-the-Prince-at-Dark-Arts-Academy",
"episodes": 50,
"tags": [
"Forbidden Love",
"Hidden Identity"
],
"genres": [
{
"id": 161,
"name": "Romance"
}
],
"views_display": "19.0K",
"status": "Completed"
},
{
"id": "42000030307",
"title": "The Hidden Princess at the All-Alpha Academy",
"description": "One princess. Two fated mates. One secret that could ruin everything. Fleeing a sinister arranged marriage, Pr…",
"cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000030307/42000030307.jpg",
"url": "https://www.dramabox.com/drama/42000030307/The-Hidden-Princess-at-the-All-Alpha-Academy",
"episodes": 50,
"tags": [
"Reverse Harem",
"Werewolf"
],
"genres": [
{
"id": 161,
"name": "Romance"
},
{
"id": 248,
"name": "Sweet Love"
}
],
"views_display": "18.0K",
"status": "Completed"
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/dramabox.homeResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | dramabox.HomeResponse | No | ||||
| data.featured | array | No | ||||
| data.featured[].cover_url | string | No | ||||
| data.featured[].description | string | No | ||||
| data.featured[].episodes | integer | No | ||||
| data.featured[].follows | integer | No | ||||
| data.featured[].genres | array | No | ||||
| data.featured[].genres[].id | integer | No | ||||
| data.featured[].genres[].name | string | No | ||||
| data.featured[].id | string | No | ||||
| data.featured[].language | string | No | ||||
| data.featured[].listed_at | string | No | ListedAt is the site's first-listing timestamp as printed ("2026-10-24 10:00:00"); its time zone is not stated by the site. | |||
| data.featured[].rating | number | No | ||||
| data.featured[].status | string | No | Status is the site's update label, for example "Completed". | |||
| data.featured[].tags | array | No | ||||
| data.featured[].title | string | No | ||||
| data.featured[].url | string | No | ||||
| data.featured[].views_display | string | No | ViewsDisplay is the view count as the site prints it ("15.6K"); it is empty where the list does not carry one. | |||
| data.language | string | No | ||||
| data.shelves | array | No | ||||
| data.shelves[].books | array | No | ||||
| data.shelves[].books[].cover_url | string | No | ||||
| data.shelves[].books[].description | string | No | ||||
| data.shelves[].books[].episodes | integer | No | ||||
| data.shelves[].books[].follows | integer | No | ||||
| data.shelves[].books[].genres | array | No | ||||
| data.shelves[].books[].genres[].id | integer | No | ||||
| data.shelves[].books[].genres[].name | string | No | ||||
| data.shelves[].books[].id | string | No | ||||
| data.shelves[].books[].language | string | No | ||||
| data.shelves[].books[].listed_at | string | No | ListedAt is the site's first-listing timestamp as printed ("2026-10-24 10:00:00"); its time zone is not stated by the site. | |||
| data.shelves[].books[].rating | number | No | ||||
| data.shelves[].books[].status | string | No | Status is the site's update label, for example "Completed". | |||
| data.shelves[].books[].tags | array | No | ||||
| data.shelves[].books[].title | string | No | ||||
| data.shelves[].books[].url | string | No | ||||
| data.shelves[].books[].views_display | string | No | ViewsDisplay is the view count as the site prints it ("15.6K"); it is empty where the list does not carry one. | |||
| data.shelves[].id | integer | No | ||||
| data.shelves[].name | string | No | ||||
| data.shelves[].position | string | No | Position is the dramabox-more position that lists this shelf in full: trending, must-sees or hidden-gems; empty for an unknown shelf. | |||
| msg | string | No | OK |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/dramabox/home?language=en" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More DramaBox endpoint docsDramaBox Short Drama APIDramaBox Genre Browse API documentationList DramaBox category filters API documentationBrowse DramaBox titles by category API documentationList DramaBox theater channels API documentationDramaBox Drama Details API documentationList DramaBox genres API documentation