Endpoint Playground

Try the DramaBox Search API

Searches the DramaBox Android app API and returns one page of mixed results: book rows (id, title, description, cover, website link, tags, protagonist) and performer rows (id, name, avatar, series count), plus an is_more flag for the next page. The keyword is trimmed and truncated to 80 characters like the app; sort selects one of the app's result orderings. Performer ids can be passed to dramabox-performer. Only public catalog metadata is read; no playable video is returned.

What a live request returned

26 Oct 2026: 40 titles; 9 fields had a value in every checked item.

Observed request: GET /dramabox/search?keyword=love&page=1&limit=40
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, protagonist

Sample value profiles: title: “Love's Encore” and 39 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 40.

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

DramaBox Search API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/search?keyword=love&sort=1' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
keyword	string	Yes	love	Search text, trimmed and truncated to 80 characters
page	integer	No		One-based result page
limit	integer	No		Results per page
sort	integer	No	1	Upstream result ordering mode; omit for the app default

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "keyword": "love",
    "page": 1,
    "limit": 20,
    "is_more": true,
    "titles": [
      {
        "id": "41000103780",
        "title": "Love's Encore",
        "description": "To get his revenge, Luke Clark masks his identity for years and marries his enemy's daughter…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000103780/41000103780.jpg?t=1749451505339&image_process=resize,h_300",
        "url": "https://www.dramabox.com/drama/41000103780",
        "episodes": 0,
        "tags": [
          "Forced Love",
          "Enemy to Lover",
          "Revenge",
          "Hidden Identity",
          "Rebirth",
          "Rebellious"
        ],
        "protagonist": "Luke Clark, Nancy Beck",
        "in_library": false
      },
      {
        "id": "41000101035",
        "title": "Love On The Run",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000101035/41000101035.jpg?t=1759057372667&image_process=resize,h_300",
        "url": "https://www.dramabox.com/drama/41000101035",
        "tags": [
          "Love at First Sight",
          "Mistaken Identity",
          "Billionaire"
        ],
        "protagonist": "Hannah Marshall,  Miguel Elsher",
        "in_library": false
      }
    ],
    "people": [
      {
        "id": "29450",
        "name": "Kyle Lovett",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/0x5/29450/29450.jpg?time=1781245424449",
        "videos": 1
      },
      {
        "id": "29262",
        "name": "Cameron Love",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/2x6/29262/29262.jpg?time=1781159442136",
        "videos": 1
      }
    ]
  }
}

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

GET /dramabox/search

Search DramaBox titles and performers

Response behavior

- `keyword` echoes the normalized keyword the service actually searched (trimmed/truncated). - `titles` holds the book rows. Each title is the same catalog card `dramabox-rank` returns: `id`, `title`, `description`, `cover_url`, `url` (the public DramaBox page), `tags`, `protagonist` and `in_library`. Search cards carry no chapter count, so `episodes` is `0` and omitted fields stay empty. - `people` holds the performer rows the app mixes into the same list: `id` (pass it to `dramabox-performer`), `name`, `avatar` (catalogue artwork, a jpg) and `videos` (how many series the performer appears in). The list is omitted when the query matched no performers. - `is_more` is the app answer's `isMore` flag; read the next `page` when it is true. The app API's `totalSize` answers `0` even when more pages exist, so it is not exposed. - An empty result set (matched nothing) is a normal `200` with empty `titles` and no `people`. - Playable media, signed stream URLs, sprite/banner assets, the app's `algorithmRecomDot` / `bookSource` tracking blobs and per-user data are never returned. Example response (`keyword=love`, shortened descriptions and lists): ```json { "code": 200, "msg": "OK", "data": { "keyword": "love", "page": 1, "limit": 20, "is_more": true, "titles": [ { "id": "41000103780", "title": "Love's Encore", "description": "To get his revenge, Luke Clark masks his identity for years and marries his enemy's daughter…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000103780/41000103780.jpg?t=1749451505339&image_process=resize,h_300", "url": "https://www.dramabox.com/drama/41000103780", "episodes": 0, "tags": ["Forced Love", "Enemy to Lover", "Revenge", "Hidden Identity", "Rebirth", "Rebellious"], "protagonist": "Luke Clark, Nancy Beck", "in_library": false }, { "id": "41000101035", "title": "Love On The Run", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000101035/41000101035.jpg?t=1759057372667&image_process=resize,h_300", "url": "https://www.dramabox.com/drama/41000101035", "tags": ["Love at First Sight", "Mistaken Identity", "Billionaire"], "protagonist": "Hannah Marshall, Miguel Elsher", "in_library": false } ], "people": [ { "id": "29450", "name": "Kyle Lovett", "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/0x5/29450/29450.jpg?time=1781245424449", "videos": 1 }, { "id": "29262", "name": "Cameron Love", "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/2x6/29262/29262.jpg?time=1781159442136", "videos": 1 } ] } } ```

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

keyword

requiredstring

Search text, trimmed and truncated to 80 characters

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": {
    "keyword": "love",
    "page": 1,
    "limit": 20,
    "is_more": true,
    "titles": [
      {
        "id": "41000103780",
        "title": "Love's Encore",
        "description": "To get his revenge, Luke Clark masks his identity for years and marries his enemy's daughter…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000103780/41000103780.jpg?t=1749451505339&image_process=resize,h_300",
        "url": "https://www.dramabox.com/drama/41000103780",
        "episodes": 0,
        "tags": [
          "Forced Love",
          "Enemy to Lover",
          "Revenge",
          "Hidden Identity",
          "Rebirth",
          "Rebellious"
        ],
        "protagonist": "Luke Clark, Nancy Beck",
        "in_library": false
      },
      {
        "id": "41000101035",
        "title": "Love On The Run",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000101035/41000101035.jpg?t=1759057372667&image_process=resize,h_300",
        "url": "https://www.dramabox.com/drama/41000101035",
        "tags": [
          "Love at First Sight",
          "Mistaken Identity",
          "Billionaire"
        ],
        "protagonist": "Hannah Marshall,  Miguel Elsher",
        "in_library": false
      }
    ],
    "people": [
      {
        "id": "29450",
        "name": "Kyle Lovett",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/0x5/29450/29450.jpg?time=1781245424449",
        "videos": 1
      },
      {
        "id": "29262",
        "name": "Cameron Love",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/2x6/29262/29262.jpg?time=1781159442136",
        "videos": 1
      }
    ]
  }
}

Try the DramaBox Search API

What a live request returned

26 Oct 2026: 40 titles; 9 fields had a value in every checked item.

Observed request: GET /dramabox/search?keyword=love&page=1&limit=40
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, protagonist

Sample value profiles: title: “Love's Encore” and 39 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 40.

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

DramaBox Search API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/search?keyword=love&sort=1' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
keyword	string	Yes	love	Search text, trimmed and truncated to 80 characters
page	integer	No		One-based result page
limit	integer	No		Results per page
sort	integer	No	1	Upstream result ordering mode; omit for the app default

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "keyword": "love",
    "page": 1,
    "limit": 20,
    "is_more": true,
    "titles": [
      {
        "id": "41000103780",
        "title": "Love's Encore",
        "description": "To get his revenge, Luke Clark masks his identity for years and marries his enemy's daughter…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000103780/41000103780.jpg?t=1749451505339&image_process=resize,h_300",
        "url": "https://www.dramabox.com/drama/41000103780",
        "episodes": 0,
        "tags": [
          "Forced Love",
          "Enemy to Lover",
          "Revenge",
          "Hidden Identity",
          "Rebirth",
          "Rebellious"
        ],
        "protagonist": "Luke Clark, Nancy Beck",
        "in_library": false
      },
      {
        "id": "41000101035",
        "title": "Love On The Run",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000101035/41000101035.jpg?t=1759057372667&image_process=resize,h_300",
        "url": "https://www.dramabox.com/drama/41000101035",
        "tags": [
          "Love at First Sight",
          "Mistaken Identity",
          "Billionaire"
        ],
        "protagonist": "Hannah Marshall,  Miguel Elsher",
        "in_library": false
      }
    ],
    "people": [
      {
        "id": "29450",
        "name": "Kyle Lovett",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/0x5/29450/29450.jpg?time=1781245424449",
        "videos": 1
      },
      {
        "id": "29262",
        "name": "Cameron Love",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/2x6/29262/29262.jpg?time=1781159442136",
        "videos": 1
      }
    ]
  }
}

Search DramaBox titles and performers

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "keyword": "love", "page": 1, "limit": 20, "is_more": true, "titles": [ { "id": "41000103780", "title": "Love's Encore", "description": "To get his revenge, Luke Clark masks his identity for years and marries his enemy's daughter…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000103780/41000103780.jpg?t=1749451505339&image_process=resize,h_300", "url": "https://www.dramabox.com/drama/41000103780", "episodes": 0, "tags": [ "Forced Love", "Enemy to Lover", "Revenge", "Hidden Identity", "Rebirth", "Rebellious" ], "protagonist": "Luke Clark, Nancy Beck", "in_library": false }, { "id": "41000101035", "title": "Love On The Run", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000101035/41000101035.jpg?t=1759057372667&image_process=resize,h_300", "url": "https://www.dramabox.com/drama/41000101035", "tags": [ "Love at First Sight", "Mistaken Identity", "Billionaire" ], "protagonist": "Hannah Marshall, Miguel Elsher", "in_library": false } ], "people": [ { "id": "29450", "name": "Kyle Lovett", "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/0x5/29450/29450.jpg?time=1781245424449", "videos": 1 }, { "id": "29262", "name": "Cameron Love", "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/2x6/29262/29262.jpg?time=1781159442136", "videos": 1 } ] } }