DramaBox Rank API

Endpoint facts

Method

GET

API path

/dramabox/rank

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

DramaBox

Response schema

#/definitions/dramabox.rankResponseDoc

How this endpoint behaves

Returns one DramaBox ranking list: the ranking tabs and 20 ranked short dramas.

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:

• rank_type: optional ranking tab: 1 (Most Trending), 2 (Top Searched) or 3 (New Releases). Omit it for the default tab, which is what the app shows first. Any other value is rejected with 400; the valid tabs are also listed in every response's tabs.

Notable 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):

{
  "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
        }
      }
    ]
  }
}

Sampled response

Request, 26 Oct 2026

GET /dramabox/rank

Items in titles

20

Fields filled in every checked item

14

Shared guides

Related