Endpoint Playground

Try the Browse DramaBox titles by category API

Returns one page of 20 DramaBox short dramas from the app's category feed, optionally filtered by values from dramabox-categories: language, production type, dub mode, either genre row and sort order. Filters are ANDed; an omitted filter means all. Each title carries its id, title, description, cover, website link, episode count, tags with tag ids, protagonist, play count, library flag and listing times. Only public catalog metadata is read; no playable video is returned.

What a live request returned

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

Observed request: GET /dramabox/category-books?limit=20
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, tag_refs

Sample value profiles: shelf_time: 2026-07-22 to 2026-10-20; episodes: 30 to 60, median 50; title: “Deadliest Prison: The Female Warden Is My Plaything” and 19 other values.

Request: GET /dramabox/category-books
Cost: 1 credit/request
Auth: apiKey

Browse DramaBox titles by category API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/category-books?production=3&dub=1&sort=1' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
language	string	No		Language/origin value from dramabox-categories' language group, e.g. 美国 (Local) or 中国 (Chinese)
production	string	No	3	Production-type value from dramabox-categories' production group: 3 (AI Drama), 1 (Live-Action), 2 (Anime)
dub	string	No	1	Dub-mode value from dramabox-categories' dub group: 1 (Dubbed), 0 (Subtitles Only)
genre	string	No		Genre value from dramabox-categories' genre_1 group, e.g. 1357 (Romance) or 1361 (Strong Heroine)
genre_2	string	No		Genre value from dramabox-categories' genre_2 group, e.g. 1392 (Second Chance) or 1359 (BL); multi-tag values such as 1324,1362 are one value
sort	string	No	1	Sort value from dramabox-categories' sort group: 1 (Trending), 2 (Latest), 3 (Unwatched)
page	integer	No		Page number, 1 to 1000; defaults to 1
limit	integer	No		Titles per page, 1 to 50; defaults to 20

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "page": 1,
    "limit": 20,
    "has_more": true,
    "titles": [
      {
        "id": "42000031027",
        "title": "Backseat Swap: Trapped with His best Friend",
        "description": "Every bump in the road pulls Annie closer to Elias—her husband Cain's best friend—and further from the marriage she is trying to save.",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031027/42000031027.jpg?t=1792641695686",
        "url": "https://www.dramabox.com/drama/42000031027",
        "episodes": 50,
        "tags": [
          "Steamy",
          "Forbidden Love",
          "Love Triangle"
        ],
        "tag_refs": [
          {
            "id": 10047,
            "name": "Steamy"
          },
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1380,
            "name": "Love Triangle"
          }
        ],
        "in_library": false,
        "shelf_time": "2026-10-20 11:00:00",
        "shelf_time_ms": 1792465200000
      }
    ]
  }
}

More DramaBox endpoints

Browse DramaBox short dramas by genre List DramaBox category filters 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 DramaBox ranking list 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.categoryBooksResponseDocDramaBox

GET /dramabox/category-books

Browse DramaBox titles by category

Response behavior

- `has_more` is the app feed's own "more pages" flag, not a page-count estimate. - An empty `titles` list is a valid page: a filter value combination with no matches is a normal 200, and so is a page past the end. - `tag_refs` pairs each tag name with its id; pass the id to `dramabox-tag`. - Cards without a title id (the feed occasionally carries a non-book promo card) are dropped. - `play_count` is only present when the app reports a plain number; the app's display strings such as `41.8M` are not converted into a fabricated count. - Playable media, episode media and recommendation telemetry are never returned. Example response (lists shortened): ```json { "code": 200, "msg": "OK", "data": { "page": 1, "limit": 20, "has_more": true, "titles": [ { "id": "42000031027", "title": "Backseat Swap: Trapped with His best Friend", "description": "Every bump in the road pulls Annie closer to Elias—her husband Cain's best friend—and further from the marriage she is trying to save.", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031027/42000031027.jpg?t=1792641695686", "url": "https://www.dramabox.com/drama/42000031027", "episodes": 50, "tags": [ "Steamy", "Forbidden Love", "Love Triangle" ], "tag_refs": [ { "id": 10047, "name": "Steamy" }, { "id": 1379, "name": "Forbidden Love" }, { "id": 1380, "name": "Love Triangle" } ], "in_library": false, "shelf_time": "2026-10-20 11:00:00", "shelf_time_ms": 1792465200000 } ] } } ```

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": {
    "page": 1,
    "limit": 20,
    "has_more": true,
    "titles": [
      {
        "id": "42000031027",
        "title": "Backseat Swap: Trapped with His best Friend",
        "description": "Every bump in the road pulls Annie closer to Elias—her husband Cain's best friend—and further from the marriage she is trying to save.",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031027/42000031027.jpg?t=1792641695686",
        "url": "https://www.dramabox.com/drama/42000031027",
        "episodes": 50,
        "tags": [
          "Steamy",
          "Forbidden Love",
          "Love Triangle"
        ],
        "tag_refs": [
          {
            "id": 10047,
            "name": "Steamy"
          },
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1380,
            "name": "Love Triangle"
          }
        ],
        "in_library": false,
        "shelf_time": "2026-10-20 11:00:00",
        "shelf_time_ms": 1792465200000
      }
    ]
  }
}

Endpoint Playground

Try the Browse DramaBox titles by category API

What a live request returned

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

Observed request: GET /dramabox/category-books?limit=20
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, tag_refs

Sample value profiles: shelf_time: 2026-07-22 to 2026-10-20; episodes: 30 to 60, median 50; title: “Deadliest Prison: The Female Warden Is My Plaything” and 19 other values.

Request: GET /dramabox/category-books
Cost: 1 credit/request
Auth: apiKey

Browse DramaBox titles by category API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/category-books?production=3&dub=1&sort=1' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
language	string	No		Language/origin value from dramabox-categories' language group, e.g. 美国 (Local) or 中国 (Chinese)
production	string	No	3	Production-type value from dramabox-categories' production group: 3 (AI Drama), 1 (Live-Action), 2 (Anime)
dub	string	No	1	Dub-mode value from dramabox-categories' dub group: 1 (Dubbed), 0 (Subtitles Only)
genre	string	No		Genre value from dramabox-categories' genre_1 group, e.g. 1357 (Romance) or 1361 (Strong Heroine)
genre_2	string	No		Genre value from dramabox-categories' genre_2 group, e.g. 1392 (Second Chance) or 1359 (BL); multi-tag values such as 1324,1362 are one value
sort	string	No	1	Sort value from dramabox-categories' sort group: 1 (Trending), 2 (Latest), 3 (Unwatched)
page	integer	No		Page number, 1 to 1000; defaults to 1
limit	integer	No		Titles per page, 1 to 50; defaults to 20

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "page": 1,
    "limit": 20,
    "has_more": true,
    "titles": [
      {
        "id": "42000031027",
        "title": "Backseat Swap: Trapped with His best Friend",
        "description": "Every bump in the road pulls Annie closer to Elias—her husband Cain's best friend—and further from the marriage she is trying to save.",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031027/42000031027.jpg?t=1792641695686",
        "url": "https://www.dramabox.com/drama/42000031027",
        "episodes": 50,
        "tags": [
          "Steamy",
          "Forbidden Love",
          "Love Triangle"
        ],
        "tag_refs": [
          {
            "id": 10047,
            "name": "Steamy"
          },
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1380,
            "name": "Love Triangle"
          }
        ],
        "in_library": false,
        "shelf_time": "2026-10-20 11:00:00",
        "shelf_time_ms": 1792465200000
      }
    ]
  }
}

More 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.categoryBooksResponseDocDramaBox

GET /dramabox/category-books

Browse DramaBox titles by category

Response behavior

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": {
    "page": 1,
    "limit": 20,
    "has_more": true,
    "titles": [
      {
        "id": "42000031027",
        "title": "Backseat Swap: Trapped with His best Friend",
        "description": "Every bump in the road pulls Annie closer to Elias—her husband Cain's best friend—and further from the marriage she is trying to save.",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000031027/42000031027.jpg?t=1792641695686",
        "url": "https://www.dramabox.com/drama/42000031027",
        "episodes": 50,
        "tags": [
          "Steamy",
          "Forbidden Love",
          "Love Triangle"
        ],
        "tag_refs": [
          {
            "id": 10047,
            "name": "Steamy"
          },
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1380,
            "name": "Love Triangle"
          }
        ],
        "in_library": false,
        "shelf_time": "2026-10-20 11:00:00",
        "shelf_time_ms": 1792465200000
      }
    ]
  }
}