Get a whole DramaBox curated shelf API

Endpoint facts

Method

GET

API path

/dramabox/more

Auth

apiKey

Credits

3 credits/request

Charged on

Successful 2xx responses only

Platform

DramaBox

Response schema

#/definitions/dramabox.moreResponseDoc

How this endpoint behaves

Returns one page of a DramaBox curated shelf, the full list behind a home page shelf.

Query parameters:

• position (required): one of trending, must-sees or hidden-gems. Anything else returns 400.
• page: optional page number, 1 to 1000. Defaults to 1. Each page holds 18 titles.
• language: optional site locale: en, ko, zhHans, zh, es, ja, de, in (Indonesian), th, tl, pt, fr, ar or it. Defaults to en.

Notable response behavior:

• name is the English shelf name (Trending, Must-sees or Hidden gems); the site prints them in Chinese.
• The three positions are the shelves the site's home page links to (checked 2026-10-26). A page past the last one returns an empty books list.
• Playable video is never returned.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "language": "en",
    "position": "trending",
    "name": "Trending",
    "page": 1,
    "total_pages": 4,
    "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",
        "rating": 7.5,
        "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",
        "rating": 8.6,
        "status": "Completed"
      },
      {
        "id": "42000029956",
        "title": "Rough Ride with My F1 Rival",
        "description": "What happens when your biggest rival becomes your billionaire boss? F1 enemies Kyle and Chase clash fiercely o…",
        "cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000029956/42000029956.jpg",
        "url": "https://www.dramabox.com/drama/42000029956/Rough-Ride-with-My-F1-Rival",
        "episodes": 50,
        "tags": [
          "Billionaire",
          "Modern"
        ],
        "genres": [
          {
            "id": 267,
            "name": "Enemies to Lovers"
          }
        ],
        "views_display": "15.2K",
        "rating": 10,
        "status": "Completed"
      }
    ]
  }
}

Sampled response

Request, 26 Oct 2026

GET /dramabox/more?position=trending

Items in books

18

Fields filled in every checked item

11

Shared guides

Related