Get DramaBox search-box suggestions API

Endpoint facts

Method

GET

API path

/dramabox/suggest

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

DramaBox

Response schema

#/definitions/dramabox.suggestResponseDoc

How this endpoint behaves

Returns the autocomplete suggestions DramaBox's Android app shows while the user types a query: mixed short-drama and performer rows.

This endpoint reads DramaBox's Android app API rather than its website pages. It needs no device, emulator or app at request time: the service reproduces the app's request signature and state header from public app material (the app's static signing key is a committed public constant, like the ReelShort signing keys) and keeps the anonymous guest session the app uses for catalogue calls internally. Only public catalog metadata is read, and no playable video is ever returned.

Query parameters:

• keyword: required partial search text. It is trimmed and, like the app, truncated to its first 80 characters. A blank keyword is rejected with 400.

Notable response behavior:

• keyword echoes the normalized keyword that was suggested on.
• items holds the suggestion rows in the app's order. Each row has a kind:
  • kind: "book" — id (a DramaBox title id), name, cover_url (catalogue jpg). Pass the id to dramabox-tag / use the title with dramabox-search.
  • kind: "actor" — id (pass it to dramabox-performer), name, avatar (catalogue jpg) and videos (how many series the performer appears in).
• Matching is loose, like the app's: a fragment can match a title's name or a performer's name (lov returns titles starting "Love…" and performers whose names contain "Lovett"/"Love").
• A query with no match is a normal 200 with an empty items list.
• 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=lov, shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "keyword": "lov",
    "items": [
      {
        "kind": "actor",
        "id": "29450",
        "name": "Kyle Lovett",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/0x5/29450/29450.jpg?time=1781245424449",
        "videos": 1
      },
      {
        "kind": "actor",
        "id": "29262",
        "name": "Cameron Love",
        "avatar": "https://hwztchapter.dramaboxdb.com/data/cppartner/2x6/29262/29262.jpg?time=1781159442136",
        "videos": 1
      },
      {
        "kind": "book",
        "id": "41000107392",
        "name": "Love Is My Paycheck",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x1/41x0/410x0/41000107392/41000107392.jpg?t=1730797030710&image_process=resize,h_300",
        "videos": 0
      },
      {
        "kind": "book",
        "id": "42000021499",
        "name": "Love In Lockup",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000021499/42000021499.jpg?t=1784619485068&image_process=resize,h_300",
        "videos": 0
      }
    ]
  }
}

Sampled response

Request, 26 Oct 2026

GET /dramabox/suggest?keyword=love

Items in items

12

Fields filled in every checked item

4

Fields empty in some or all items

2

Shared guides

Related