DramaBox API endpoint
Returns the DramaBox Android app API's search landing page: the hot, trending and new-release title lists, the ranking tabs (pass a tab's type to dramabox-rank as rank_type) and the app's preset search keyword. Takes no parameters. Only public catalog metadata is read; no playable video is returned.
/dramabox/trendingReturns the three fixed title feeds on DramaBox's Android app search landing page, the ranking tabs and the app's preset search keyword.
This endpoint reads DramaBox's Android app API rather than its website pages. It needs no device, emulator or app at request time: the service reproduces the app's request signature and state header from public app material (the app's static signing key is a committed public constant, like the ReelShort signing keys) and keeps the anonymous guest session the app uses for catalogue calls internally. Only public catalog metadata is read, and no playable video is ever returned.
Query parameters: none.
Notable response behavior:
hot is the app's "hot" list, trending its trending list and new_releases its new-release
list. Each is a list of catalog cards with the same shape dramabox-rank returns (id, title,
description, cover_url, url, tags, protagonist, in_library); each list was 20 titles
upstream.rank_tabs lists the ranking tabs, each with the type to pass back to a ranking list and the
app's display name. The app's own order is preserved (observed 2 Top Searched, 1 Most
Trending, 3 New Releases) — do not assume it is sorted.preset_keyword is the word the app pre-fills in its search box; pass it to dramabox-search or
dramabox-suggest.algorithmRecomDot /
bookSource tracking blobs and per-user data are never returned.Example response (shortened; each feed was truncated to two titles):
{
"code": 200,
"msg": "OK",
"data": {
"hot": [
{
"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 she hates…",
"cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000030998/42000030998.jpg?t=1792120505057&image_process=resize,h_300",
"url": "https://www.dramabox.com/drama/42000030998",
"tags": ["Forbidden Love", "Hidden Identity", "Romance", "Enemy to Lover", "Supernatural", "Family Intrigue"],
"protagonist": "Damien Dalca, Margo Santiago",
"in_library": false
},
{
"id": "42000028173",
"title": "Love Is A Dangerous Game",
"cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg?t=1790565765766&image_process=resize,h_300",
"url": "https://www.dramabox.com/drama/42000028173",
"tags": ["Forbidden Love", "Hidden Identity", "Billionaire"],
"protagonist": "Damien, Olivia",
"in_library": false
}
],
"trending": [
{
"id": "42000030998",
"title": "Falling for the Prince at Dark Arts Academy",
"url": "https://www.dramabox.com/drama/42000030998",
"in_library": false
}
],
"new_releases": [
{
"id": "42000030917",
"title": "Halloween Horror Night Game: Tempt the Vampire to Survive",
"url": "https://www.dramabox.com/drama/42000030917",
"in_library": false
}
],
"rank_tabs": [
{ "type": 2, "name": "Top Searched" },
{ "type": 1, "name": "Most Trending" },
{ "type": 3, "name": "New Releases" }
],
"preset_keyword": "Falling for the Prince at Dark Arts Academy"
}
}
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| title | 20 | “Falling for the Prince at Dark Arts Academy” and 19 other values |
| description | 20 | median 389 characters |
| cover_url | 20 | hwztchapter.dramaboxdb.com |
| url | 20 | dramabox.com |
| episodes | 20 | 0 |
| tags | 20 | median 6 entries |
| protagonist | 20 | “Damien Dalca, Margo Santiago” and 19 other values |
| in_library | 20 | true in 0 of 20 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/dramabox/trending" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"hot": [
{
"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 she hates…",
"cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000030998/42000030998.jpg?t=1792120505057&image_process=resize,h_300",
"url": "https://www.dramabox.com/drama/42000030998",
"tags": [
"Forbidden Love",
"Hidden Identity",
"Romance",
"Enemy to Lover",
"Supernatural",
"Family Intrigue"
],
"protagonist": "Damien Dalca, Margo Santiago",
"in_library": false
},
{
"id": "42000028173",
"title": "Love Is A Dangerous Game",
"cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg?t=1790565765766&image_process=resize,h_300",
"url": "https://www.dramabox.com/drama/42000028173",
"tags": [
"Forbidden Love",
"Hidden Identity",
"Billionaire"
],
"protagonist": "Damien, Olivia",
"in_library": false
}
],
"trending": [
{
"id": "42000030998",
"title": "Falling for the Prince at Dark Arts Academy",
"url": "https://www.dramabox.com/drama/42000030998",
"in_library": false
}
],
"new_releases": [
{
"id": "42000030917",
"title": "Halloween Horror Night Game: Tempt the Vampire to Survive",
"url": "https://www.dramabox.com/drama/42000030917",
"in_library": false
}
],
"rank_tabs": [
{
"type": 2,
"name": "Top Searched"
},
{
"type": 1,
"name": "Most Trending"
},
{
"type": 3,
"name": "New Releases"
}
],
"preset_keyword": "Falling for the Prince at Dark Arts Academy"
}
}Request schema
No body schema
Response schema
#/definitions/dramabox.trendingResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | dramabox.TrendingResponse | No | ||||
| data.hot | array | No | AppTitle record, 15 fields: cover_url, description, episodes, id, in_library, play_count, protagonist, shelf_time, shelf_time_ms, tag_refs, tags, title and 1 more. Described under DramaBox Tag API. | |||
| data.new_releases | array | No | NewReleases is the app's new-release list. AppTitle record, 15 fields: cover_url, description, episodes, id, in_library, play_count, protagonist, shelf_time, shelf_time_ms, tag_refs, tags, title and 1 more. Described under DramaBox Tag API. | |||
| data.preset_keyword | string | No | PresetKeyword is the word the app pre-fills in its search box. | |||
| data.rank_tabs | array | No | RankTabs are the ranking tabs; a tab's type is a valid rank_type for dramabox-rank. | |||
| data.rank_tabs[].name | string | No | ||||
| data.rank_tabs[].type | integer | No | Type is the value to pass as rank_type. | |||
| data.trending | array | No | Trending is the app's trending list. AppTitle record, 15 fields: cover_url, description, episodes, id, in_library, play_count, protagonist, shelf_time, shelf_time_ms, tag_refs, tags, title and 1 more. Described under DramaBox Tag API. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/dramabox/trending" \
-H "x-api-key: $CRAWLORA_API_KEY"