Endpoint Playground

Try the DramaBox Rank API

Returns one DramaBox ranking list from the DramaBox Android app API: the available tabs (Most Trending, Top Searched, New Releases) and 20 ranked titles, each with its id, title, description, cover, website link, episode count, tags, protagonist, rank position, hot metric, library flag and listing times. Pass a tab's type as rank_type to read that tab. Only public catalog metadata is read; no playable video is returned.

What a live request returned

26 Oct 2026: 20 titles; 14 fields had a value in every checked item.

Observed request: GET /dramabox/rank
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, protagonist

Sample value profiles: shelf_time: 2026-06-25 to 2026-10-20; episodes: 30 to 58, median 50; title: “Falling for the Prince at Dark Arts Academy” and 19 other values.

Request: GET /dramabox/rank
Cost: 1 credit/request
Auth: apiKey

DramaBox Rank API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/rank?rank_type=1' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
rank_type	integer	No	1	Ranking tab: 1 (Most Trending), 2 (Top Searched), 3 (New Releases); omit for the default tab

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "rank_type": 1,
    "tabs": [
      {
        "type": 1,
        "name": "Most Trending"
      },
      {
        "type": 2,
        "name": "Top Searched"
      },
      {
        "type": 3,
        "name": "New Releases"
      }
    ],
    "titles": [
      {
        "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…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg?t=1790565765766",
        "url": "https://www.dramabox.com/drama/42000028173",
        "episodes": 43,
        "tags": [
          "Forbidden Love",
          "Hidden Identity",
          "Billionaire"
        ],
        "protagonist": "Damien,  Olivia",
        "position": 1,
        "in_library": false,
        "data_from": "大数据",
        "shelf_time": "2026-09-27 16:42:18",
        "shelf_time_ms": 1790042404000,
        "rank": {
          "type": 1,
          "hot_code": "1.6M",
          "sort": 1
        }
      },
      {
        "id": "42000021382",
        "title": "Deny Me, Dragon King",
        "description": "Human Lyra stumbles on Dragon King Kael and shares a passionate night…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021382/42000021382.jpg?t=1790565000000",
        "url": "https://www.dramabox.com/drama/42000021382",
        "episodes": 50,
        "tags": [
          "Single Mom",
          "Secret Baby"
        ],
        "protagonist": "Kael,  Lyra",
        "position": 2,
        "in_library": false,
        "data_from": "编辑精选",
        "shelf_time": "2026-09-27 16:42:19",
        "shelf_time_ms": 1790042405000,
        "rank": {
          "type": 1,
          "hot_code": "1M",
          "sort": 2
        }
      }
    ]
  }
}

More DramaBox endpoints

Browse DramaBox short dramas by genre List DramaBox category filters Browse DramaBox titles by category List DramaBox theater channels Get a DramaBox short drama and its episodes List DramaBox genres List DramaBox's featured titles and shelves Get a whole DramaBox curated shelf Get a DramaBox performer and their titles Get a page of DramaBox's recommendation feed Search DramaBox titles and performers Get DramaBox search-box suggestions All 16 DramaBox endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdramabox.rankResponseDocDramaBox

GET /dramabox/rank

Get a DramaBox ranking list

Response behavior

- `tabs` lists the ranking tabs with the `type` to pass back as `rank_type` and the app's display `name`. - `titles` holds the ranking list, fixed at 20 titles upstream. `position` is the title's ordinal in the ranking (1-based, taken from the app's own `rankVo.sort`), and `rank` carries that object's `hot_code` and `type`. - `episodes` is the total chapter count, not a number of free episodes. - `shelf_time` is the app's listing time as printed; `shelf_time_ms` is the same instant in Unix milliseconds. - `in_library` is always `false` for this shared guest session, because nobody's library is being read. - Playable media, signed stream URLs, sprite/banner assets and per-user data are never returned. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "rank_type": 1, "tabs": [ { "type": 1, "name": "Most Trending" }, { "type": 2, "name": "Top Searched" }, { "type": 3, "name": "New Releases" } ], "titles": [ { "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…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg?t=1790565765766", "url": "https://www.dramabox.com/drama/42000028173", "episodes": 43, "tags": [ "Forbidden Love", "Hidden Identity", "Billionaire" ], "protagonist": "Damien, Olivia", "position": 1, "in_library": false, "data_from": "大数据", "shelf_time": "2026-09-27 16:42:18", "shelf_time_ms": 1790042404000, "rank": { "type": 1, "hot_code": "1.6M", "sort": 1 } }, { "id": "42000021382", "title": "Deny Me, Dragon King", "description": "Human Lyra stumbles on Dragon King Kael and shares a passionate night…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021382/42000021382.jpg?t=1790565000000", "url": "https://www.dramabox.com/drama/42000021382", "episodes": 50, "tags": [ "Single Mom", "Secret Baby" ], "protagonist": "Kael, Lyra", "position": 2, "in_library": false, "data_from": "编辑精选", "shelf_time": "2026-09-27 16:42:19", "shelf_time_ms": 1790042405000, "rank": { "type": 1, "hot_code": "1M", "sort": 2 } } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "rank_type": 1,
    "tabs": [
      {
        "type": 1,
        "name": "Most Trending"
      },
      {
        "type": 2,
        "name": "Top Searched"
      },
      {
        "type": 3,
        "name": "New Releases"
      }
    ],
    "titles": [
      {
        "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…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg?t=1790565765766",
        "url": "https://www.dramabox.com/drama/42000028173",
        "episodes": 43,
        "tags": [
          "Forbidden Love",
          "Hidden Identity",
          "Billionaire"
        ],
        "protagonist": "Damien,  Olivia",
        "position": 1,
        "in_library": false,
        "data_from": "大数据",
        "shelf_time": "2026-09-27 16:42:18",
        "shelf_time_ms": 1790042404000,
        "rank": {
          "type": 1,
          "hot_code": "1.6M",
          "sort": 1
        }
      },
      {
        "id": "42000021382",
        "title": "Deny Me, Dragon King",
        "description": "Human Lyra stumbles on Dragon King Kael and shares a passionate night…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021382/42000021382.jpg?t=1790565000000",
        "url": "https://www.dramabox.com/drama/42000021382",
        "episodes": 50,
        "tags": [
          "Single Mom",
          "Secret Baby"
        ],
        "protagonist": "Kael,  Lyra",
        "position": 2,
        "in_library": false,
        "data_from": "编辑精选",
        "shelf_time": "2026-09-27 16:42:19",
        "shelf_time_ms": 1790042405000,
        "rank": {
          "type": 1,
          "hot_code": "1M",
          "sort": 2
        }
      }
    ]
  }
}

Try the DramaBox Rank API

What a live request returned

26 Oct 2026: 20 titles; 14 fields had a value in every checked item.

Observed request: GET /dramabox/rank
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, protagonist

Sample value profiles: shelf_time: 2026-06-25 to 2026-10-20; episodes: 30 to 58, median 50; title: “Falling for the Prince at Dark Arts Academy” and 19 other values.

Request: GET /dramabox/rank
Cost: 1 credit/request
Auth: apiKey

DramaBox Rank API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/rank?rank_type=1' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
rank_type	integer	No	1	Ranking tab: 1 (Most Trending), 2 (Top Searched), 3 (New Releases); omit for the default tab

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "rank_type": 1,
    "tabs": [
      {
        "type": 1,
        "name": "Most Trending"
      },
      {
        "type": 2,
        "name": "Top Searched"
      },
      {
        "type": 3,
        "name": "New Releases"
      }
    ],
    "titles": [
      {
        "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…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg?t=1790565765766",
        "url": "https://www.dramabox.com/drama/42000028173",
        "episodes": 43,
        "tags": [
          "Forbidden Love",
          "Hidden Identity",
          "Billionaire"
        ],
        "protagonist": "Damien,  Olivia",
        "position": 1,
        "in_library": false,
        "data_from": "大数据",
        "shelf_time": "2026-09-27 16:42:18",
        "shelf_time_ms": 1790042404000,
        "rank": {
          "type": 1,
          "hot_code": "1.6M",
          "sort": 1
        }
      },
      {
        "id": "42000021382",
        "title": "Deny Me, Dragon King",
        "description": "Human Lyra stumbles on Dragon King Kael and shares a passionate night…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021382/42000021382.jpg?t=1790565000000",
        "url": "https://www.dramabox.com/drama/42000021382",
        "episodes": 50,
        "tags": [
          "Single Mom",
          "Secret Baby"
        ],
        "protagonist": "Kael,  Lyra",
        "position": 2,
        "in_library": false,
        "data_from": "编辑精选",
        "shelf_time": "2026-09-27 16:42:19",
        "shelf_time_ms": 1790042405000,
        "rank": {
          "type": 1,
          "hot_code": "1M",
          "sort": 2
        }
      }
    ]
  }
}

Get a DramaBox ranking list

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "rank_type": 1, "tabs": [ { "type": 1, "name": "Most Trending" }, { "type": 2, "name": "Top Searched" }, { "type": 3, "name": "New Releases" } ], "titles": [ { "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…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg?t=1790565765766", "url": "https://www.dramabox.com/drama/42000028173", "episodes": 43, "tags": [ "Forbidden Love", "Hidden Identity", "Billionaire" ], "protagonist": "Damien, Olivia", "position": 1, "in_library": false, "data_from": "大数据", "shelf_time": "2026-09-27 16:42:18", "shelf_time_ms": 1790042404000, "rank": { "type": 1, "hot_code": "1.6M", "sort": 1 } }, { "id": "42000021382", "title": "Deny Me, Dragon King", "description": "Human Lyra stumbles on Dragon King Kael and shares a passionate night…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021382/42000021382.jpg?t=1790565000000", "url": "https://www.dramabox.com/drama/42000021382", "episodes": 50, "tags": [ "Single Mom", "Secret Baby" ], "protagonist": "Kael, Lyra", "position": 2, "in_library": false, "data_from": "编辑精选", "shelf_time": "2026-09-27 16:42:19", "shelf_time_ms": 1790042405000, "rank": { "type": 1, "hot_code": "1M", "sort": 2 } } ] } }