DramaBox Genre Browse API

Endpoint facts

Method

GET

API path

/dramabox/browse

Auth

apiKey

Credits

3 credits/request

Charged on

Successful 2xx responses only

Platform

DramaBox

Response schema

#/definitions/dramabox.browseResponseDoc

How this endpoint behaves

Query parameters:

• genre_id: optional genre id from dramabox-genres. 0 or omitted browses all titles. An id that is not a genre returns 400.
• page: optional page number, 1 to 1000. Defaults to 1. Each page holds 12 titles.
• language: optional site locale: en, ko, zhHans, zh, es, ja, de, in (Indonesian), th, tl, pt, fr, ar or it. Defaults to en. Each locale has its own library, so a small one can run out of pages early.

Notable response behavior:

• total_pages is the page count for the genre (about 250 for all titles). A page past the last one returns an empty books list and total_pages 0, not an error.
• genre_name is all when no genre is given.
• Playable video is never returned.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "language": "en",
    "genre_id": 161,
    "genre_name": "Romance",
    "page": 1,
    "total_pages": 184,
    "books": [
      {
        "id": "42000031374",
        "title": "The Elf Queen's Choice",
        "description": "Aethera, last Starlight Elf queen, wields Star Speech. On her betrothal eve, she catches fiancé Cassian with c…",
        "cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031374/42000031374.jpg",
        "url": "https://www.dramabox.com/drama/42000031374/The-Elf-Queens-Choice",
        "episodes": 50,
        "tags": [
          "Forbidden Love",
          "Royalty"
        ],
        "genres": [
          {
            "id": 161,
            "name": "Romance"
          },
          {
            "id": 291,
            "name": "Fantasy"
          },
          {
            "id": 583,
            "name": "Forbidden Love"
          }
        ],
        "views_display": "0",
        "follows": 4555,
        "rating": 9.8,
        "status": "Completed",
        "language": "en",
        "listed_at": "2026-10-24 10:00:00"
      },
      {
        "id": "42000031105",
        "title": "Husbands in the Backseat",
        "description": "A four-person road trip, two seemingly loving couples, hiding the dirtiest of secrets. Liam, a fitness trainer…",
        "cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031105/42000031105.jpg",
        "url": "https://www.dramabox.com/drama/42000031105/Husbands-in-the-Backseat",
        "episodes": 52,
        "tags": [
          "Billionaire",
          "Forbidden Love"
        ],
        "genres": [
          {
            "id": 161,
            "name": "Romance"
          },
          {
            "id": 583,
            "name": "Forbidden Love"
          }
        ],
        "views_display": "0",
        "follows": 26933,
        "rating": 9.4,
        "status": "Completed",
        "language": "en",
        "listed_at": "2026-10-24 10:00:00"
      },
      {
        "id": "42000031249",
        "title": "No Escape from My Alpha Professor",
        "description": "Low-ranking Omega Liora stumbles into a werewolf academy sex party, where Anna drugs and humiliates her—yet sh…",
        "cover_url": "https://thwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031249/42000031249.jpg",
        "url": "https://www.dramabox.com/drama/42000031249/No-Escape-from-My-Alpha-Professor",
        "episodes": 40,
        "tags": [
          "Love After Marriage",
          "Revenge"
        ],
        "genres": [
          {
            "id": 161,
            "name": "Romance"
          }
        ],
        "views_display": "15.1K",
        "follows": 17476,
        "rating": 8.4,
        "status": "Completed",
        "language": "en",
        "listed_at": "2026-10-24 00:00:01"
      }
    ]
  }
}

Sampled response

Request, 26 Oct 2026

GET /dramabox/browse

Items in books

12

Fields filled in every checked item

14

Shared guides

Related