Endpoint Playground

Try the DramaBox Recommendations API

Returns one page of DramaBox's own "You Might Like" recommendation feed from the Android app API: the feed title and its titles, each with id, title, description, cover, website link, episode count, tags with their tag ids, protagonist, library flag and listing times. The upstream page size is fixed, so page is the only paging control. Only public catalog metadata is read; no playable video is returned.

What a live request returned

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

Observed request: GET /dramabox/recommend?page=1
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, tag_refs

Sample value profiles: shelf_time: 2026-03-23 to 2026-10-25; episodes: 31 to 63, median 46; title: “Falling for the Prince at Dark Arts Academy” and 8 other values.

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

DramaBox Recommendations API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/recommend' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
page	integer	No		Page number, 1 to 1000; defaults to 1

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "You Might Like",
    "page_size": 9,
    "page": 1,
    "has_more": true,
    "titles": [
      {
        "id": "42000029957",
        "title": "Deadliest Prison: The Female Warden Is",
        "description": "A short drama picked for you…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000029957/42000029957.jpg",
        "url": "https://www.dramabox.com/drama/42000029957",
        "episodes": 40,
        "tags": [
          "Prison",
          "Revenge"
        ],
        "tag_refs": [
          {
            "id": 1357,
            "name": "Romance"
          }
        ],
        "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 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.recommendResponseDocDramaBox

GET /dramabox/recommend

Get a page of DramaBox's recommendation feed

Response behavior

- `title` is the feed's own heading ("You Might Like" in the observed answers). - `titles` holds the feed's titles, each with id, title, description, cover, website link, episode count, tags with their tag ids, protagonist, library flag and listing times. - `page_size` is the upstream page size; callers cannot choose it. - `has_more` is true when a later page exists (the feed has two pages in the observed answers). - The sibling app route that returns a "recommended channel" answer is deliberately not built: that answer carries episode entries with playable `videoPath` media. - Playable media, signed stream URLs and per-user data are never returned. Example response (lists shortened): ```json { "code": 200, "msg": "OK", "data": { "title": "You Might Like", "page_size": 9, "page": 1, "has_more": true, "titles": [ { "id": "42000029957", "title": "Deadliest Prison: The Female Warden Is", "description": "A short drama picked for you…", "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000029957/42000029957.jpg", "url": "https://www.dramabox.com/drama/42000029957", "episodes": 40, "tags": ["Prison", "Revenge"], "tag_refs": [ { "id": 1357, "name": "Romance" } ], "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

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": {
    "title": "You Might Like",
    "page_size": 9,
    "page": 1,
    "has_more": true,
    "titles": [
      {
        "id": "42000029957",
        "title": "Deadliest Prison: The Female Warden Is",
        "description": "A short drama picked for you…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000029957/42000029957.jpg",
        "url": "https://www.dramabox.com/drama/42000029957",
        "episodes": 40,
        "tags": [
          "Prison",
          "Revenge"
        ],
        "tag_refs": [
          {
            "id": 1357,
            "name": "Romance"
          }
        ],
        "in_library": false
      }
    ]
  }
}

Endpoint Playground

Try the DramaBox Recommendations API

What a live request returned

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

Observed request: GET /dramabox/recommend?page=1
Fields with a value in every checked item: id, title, description, cover_url, url, episodes, tags, tag_refs

Sample value profiles: shelf_time: 2026-03-23 to 2026-10-25; episodes: 31 to 63, median 46; title: “Falling for the Prince at Dark Arts Academy” and 8 other values.

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

DramaBox Recommendations API documentation DramaBox platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/dramabox/recommend' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
page	integer	No		Page number, 1 to 1000; defaults to 1

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "You Might Like",
    "page_size": 9,
    "page": 1,
    "has_more": true,
    "titles": [
      {
        "id": "42000029957",
        "title": "Deadliest Prison: The Female Warden Is",
        "description": "A short drama picked for you…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000029957/42000029957.jpg",
        "url": "https://www.dramabox.com/drama/42000029957",
        "episodes": 40,
        "tags": [
          "Prison",
          "Revenge"
        ],
        "tag_refs": [
          {
            "id": 1357,
            "name": "Romance"
          }
        ],
        "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.recommendResponseDocDramaBox

GET /dramabox/recommend

Get a page of DramaBox's recommendation feed

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": {
    "title": "You Might Like",
    "page_size": 9,
    "page": 1,
    "has_more": true,
    "titles": [
      {
        "id": "42000029957",
        "title": "Deadliest Prison: The Female Warden Is",
        "description": "A short drama picked for you…",
        "cover_url": "https://hwztchapter.dramaboxdb.com/data/cppartner/4x2/42x0/420x0/42000029957/42000029957.jpg",
        "url": "https://www.dramabox.com/drama/42000029957",
        "episodes": 40,
        "tags": [
          "Prison",
          "Revenge"
        ],
        "tag_refs": [
          {
            "id": 1357,
            "name": "Romance"
          }
        ],
        "in_library": false
      }
    ]
  }
}