DramaBox Drama Details API

Endpoint facts

Method

GET

API path

/dramabox/drama

Auth

apiKey

Credits

3 credits/request

Charged on

Successful 2xx responses only

Platform

DramaBox

Response schema

#/definitions/dramabox.dramaResponseDoc

How this endpoint behaves

id is required: the numeric title id from dramabox-browse, dramabox-more or dramabox-home. A dramabox.com/drama/... URL is also accepted.

Notable response behavior:

• episodes lists every episode with its 1-based number, id, duration_ms, updated_at and thumbnail. free is true for the episodes the site unlocks without payment (typically the first few); the rest are paid on DramaBox.
• views and follows are the title's lifetime counters.
• listed_at and updated_at are printed by the site without a time zone, so they are returned as the site prints them.
• available_languages lists the site locales that carry the title.
• Playable video is never returned.
• An unknown title id returns 404; a malformed id returns 400.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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",
    "language": "en",
    "episode_count": 43,
    "views": 86603866,
    "follows": 3361355,
    "tags": [
      "Billionaire",
      "Forbidden Love"
    ],
    "genres": [
      {
        "id": 258,
        "name": "Billionaire"
      },
      {
        "id": 583,
        "name": "Forbidden Love"
      },
      {
        "id": 265,
        "name": "Concealed Identity"
      }
    ],
    "listed_at": "2026-09-22 10:00:04",
    "updated_at": "2026-09-27 16:42:18",
    "available_languages": [
      "en"
    ],
    "episodes": [
      {
        "number": 1,
        "id": "701673570",
        "free": true,
        "duration_ms": 102451,
        "updated_at": "2026-10-20",
        "thumbnail_url": "https://thwztvideo.dramaboxdb.com/07/3x7/37x1/371x8/37182000024/701673570_3/701673570.mp4.jpg"
      },
      {
        "number": 2,
        "id": "701673571",
        "free": true,
        "duration_ms": 82526,
        "updated_at": "2026-10-20",
        "thumbnail_url": "https://thwztvideo.dramaboxdb.com/17/3x7/37x1/371x8/37182000024/701673571_2/701673571.mp4.jpg"
      },
      {
        "number": 3,
        "id": "701673572",
        "free": true,
        "duration_ms": 99593,
        "updated_at": "2026-10-20",
        "thumbnail_url": "https://thwztvideo.dramaboxdb.com/27/3x7/37x1/371x8/37182000024/701673572_2/701673572.mp4.jpg"
      }
    ],
    "related": [
      {
        "id": "42000031399",
        "title": "She Saves His Empire, Then Goes Shopping",
        "description": "Claire Walsh seems like Adrian Carter's spoiled shopper, swiping his black card on bags. Actually, she's a ret…",
        "cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031399/42000031399.jpg",
        "url": "https://www.dramabox.com/drama/42000031399/She-Saves-His-Empire-Then-Goes-Shopping",
        "episodes": 60,
        "tags": [
          "Comeback Story",
          "Billionaire"
        ],
        "genres": [
          {
            "id": 258,
            "name": "Billionaire"
          },
          {
            "id": 676,
            "name": "Betrayal"
          }
        ],
        "follows": 368,
        "language": "en",
        "listed_at": "2026-10-21 15:45:12"
      },
      {
        "id": "42000031669",
        "title": "She Fired Her Own Future",
        "description": "Claire Clark and her husband Gavin Stone built an empire but work undercover as cleaners in their own plaza. A…",
        "cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031669/42000031669.jpg",
        "url": "https://www.dramabox.com/drama/42000031669/She-Fired-Her-Own-Future",
        "episodes": 40,
        "tags": [
          "Family Bonds",
          "Billionaire"
        ],
        "genres": [
          {
            "id": 498,
            "name": "Family"
          },
          {
            "id": 258,
            "name": "Billionaire"
          }
        ],
        "follows": 421,
        "language": "en",
        "listed_at": "2026-10-23 13:35:15"
      },
      {
        "id": "42000030867",
        "title": "My Ex's Forbidden Brother",
        "description": "Maya catches her boyfriend cheating with her stepsister. In a fit of impulse, she throws herself into the arms…",
        "cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000030867/42000030867.jpg",
        "url": "https://www.dramabox.com/drama/42000030867/My-Exs-Forbidden-Brother",
        "episodes": 56,
        "tags": [
          "Billionaire",
          "Revenge"
        ],
        "genres": [
          {
            "id": 161,
            "name": "Romance"
          },
          {
            "id": 258,
            "name": "Billionaire"
          },
          {
            "id": 260,
            "name": "Revenge"
          }
        ],
        "follows": 6515,
        "language": "en",
        "listed_at": "2026-10-16 10:00:03"
      }
    ]
  }
}

Sampled response

Request, 26 Oct 2026

GET /dramabox/drama?id=42000028173

Items in episodes

43

Fields filled in every checked item

6

Shared guides

Related