Endpoint Playground

Try the DramaBox Tag API

Returns one page of DramaBox titles carrying a tag, as the Android app shows them: each title's id, title, description, cover, website link, episode count, tags with their tag ids, protagonist, library flag and listing times, plus the tag's own name. Get tag ids from any title result's tag_refs (dramabox-rank, dramabox-search, dramabox-category-books and the other list endpoints all expose them). An unknown tag id returns an empty list rather than an error. 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/tag?tag_id=1379&page=1&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-08-01 to 2026-10-24; episodes: 30 to 60, median 50; title: “Love Is A Dangerous Game” and 19 other values.

Request: GET /dramabox/tag
Cost: 1 credit/request
Auth: apiKey

DramaBox Tag API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/tag?tag_id=1379' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
tag_id	integer	Yes	1379	Tag id from any title result's tag_refs
page	integer	No		Page number, 1 to 1000; defaults to 1
limit	integer	No		Page size, 1 to 50; defaults to 20

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tag_id": 1379,
    "tag_name": "Forbidden Love",
    "page": 1,
    "limit": 20,
    "has_more": false,
    "titles": [
      {
        "id": "42000028173",
        "title": "Love Is A Dangerous Game",
        "description": "Olivia is dragged by her husband Ryan to a couples-swapping getaway…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg",
        "url": "https://www.dramabox.com/drama/42000028173",
        "episodes": 43,
        "tags": [
          "Forbidden Love",
          "Hidden Identity"
        ],
        "tag_refs": [
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1395,
            "name": "Hidden Identity"
          }
        ],
        "in_library": false
      }
    ]
  }
}

More DramaBox endpoints

Browse DramaBox short dramas by genre List DramaBox category filters Browse DramaBox titles by category 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 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.tagResponseDocDramaBox

GET /dramabox/tag

List the DramaBox titles carrying a tag

Response behavior

- The endpoint's tag value space is the tag ids carried by titles; the app has no separate tag-list route, so `tag_refs` on any title is the discovery surface. - An unknown `tag_id` returns HTTP 200 with `titles: []` and `has_more: false`, not `404` — the app API answers an empty page for a tag it does not know. - `tag_name` is the tag's display name when the upstream knows the id. - Each title carries its own `tag_refs`, so a lookup can be walked from tag to tag. - `has_more` is true when a later page exists. - Playable media, signed stream URLs and per-user data are never returned. Example response (lists shortened): ```json { "code": 200, "msg": "OK", "data": { "tag_id": 1379, "tag_name": "Forbidden Love", "page": 1, "limit": 20, "has_more": false, "titles": [ { "id": "42000028173", "title": "Love Is A Dangerous Game", "description": "Olivia is dragged by her husband Ryan to a couples-swapping getaway…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg", "url": "https://www.dramabox.com/drama/42000028173", "episodes": 43, "tags": ["Forbidden Love", "Hidden Identity"], "tag_refs": [ { "id": 1379, "name": "Forbidden Love" }, { "id": 1395, "name": "Hidden Identity" } ], "in_library": false } ] } } ```

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

Required query parameters

tag_id

requiredinteger

Tag id from any title result's tag_refs

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": {
    "tag_id": 1379,
    "tag_name": "Forbidden Love",
    "page": 1,
    "limit": 20,
    "has_more": false,
    "titles": [
      {
        "id": "42000028173",
        "title": "Love Is A Dangerous Game",
        "description": "Olivia is dragged by her husband Ryan to a couples-swapping getaway…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg",
        "url": "https://www.dramabox.com/drama/42000028173",
        "episodes": 43,
        "tags": [
          "Forbidden Love",
          "Hidden Identity"
        ],
        "tag_refs": [
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1395,
            "name": "Hidden Identity"
          }
        ],
        "in_library": false
      }
    ]
  }
}

Endpoint Playground

Try the DramaBox Tag API

What a live request returned

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

Observed request: GET /dramabox/tag?tag_id=1379&page=1&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-08-01 to 2026-10-24; episodes: 30 to 60, median 50; title: “Love Is A Dangerous Game” and 19 other values.

Request: GET /dramabox/tag
Cost: 1 credit/request
Auth: apiKey

DramaBox Tag API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/tag?tag_id=1379' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
tag_id	integer	Yes	1379	Tag id from any title result's tag_refs
page	integer	No		Page number, 1 to 1000; defaults to 1
limit	integer	No		Page size, 1 to 50; defaults to 20

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tag_id": 1379,
    "tag_name": "Forbidden Love",
    "page": 1,
    "limit": 20,
    "has_more": false,
    "titles": [
      {
        "id": "42000028173",
        "title": "Love Is A Dangerous Game",
        "description": "Olivia is dragged by her husband Ryan to a couples-swapping getaway…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg",
        "url": "https://www.dramabox.com/drama/42000028173",
        "episodes": 43,
        "tags": [
          "Forbidden Love",
          "Hidden Identity"
        ],
        "tag_refs": [
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1395,
            "name": "Hidden Identity"
          }
        ],
        "in_library": false
      }
    ]
  }
}

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.tagResponseDocDramaBox

GET /dramabox/tag

List the DramaBox titles carrying a tag

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

Required query parameters

tag_id

requiredinteger

Tag id from any title result's tag_refs

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": {
    "tag_id": 1379,
    "tag_name": "Forbidden Love",
    "page": 1,
    "limit": 20,
    "has_more": false,
    "titles": [
      {
        "id": "42000028173",
        "title": "Love Is A Dangerous Game",
        "description": "Olivia is dragged by her husband Ryan to a couples-swapping getaway…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000028173/42000028173.jpg",
        "url": "https://www.dramabox.com/drama/42000028173",
        "episodes": 43,
        "tags": [
          "Forbidden Love",
          "Hidden Identity"
        ],
        "tag_refs": [
          {
            "id": 1379,
            "name": "Forbidden Love"
          },
          {
            "id": 1395,
            "name": "Hidden Identity"
          }
        ],
        "in_library": false
      }
    ]
  }
}