Docs menu

DramaBox API endpoint

List DramaBox theater channels API

Returns the 8 DramaBox app theater channels as ids and names: Popular, New, Rankings, Categories, Anime, Live-Action, VIP and Original+. The channel value for dramabox-theater is the lowercase name (popular, new, rankings, categories, anime, live-action, vip, original). Only public catalog metadata is read; no playable video is returned.

GETapiKey1 credit/requestDramaBoxdramabox.channelsResponseDoc/dramabox/channels

Endpoint facts

Method: GET
API path: /dramabox/channels
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: DramaBox
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/dramabox.channelsResponseDoc

DramaBox Short Drama API Try List DramaBox theater channels API in Playground DramaBox API documentation

How this endpoint behaves

Returns the DramaBox app's 8 theater channels. This is the closed value space for dramabox-theater's channel parameter.

This endpoint reads DramaBox's Android app API rather than its website pages, device-free. Only public catalog metadata is read; no playable video is returned.

Query parameters: none.

Channel values for dramabox-theater (the lowercase name), with the app's display name and the upstream channel id it maps to:

popular — Popular (155)
new — New (41)
rankings — Rankings (89)
categories — Categories (141)
anime — Anime (290)
live-action — Live-Action (314)
vip — VIP (291)
original — Original+ (13)

Notable response behavior:

id is the app's own channel id; pass the lowercase name as channel to dramabox-theater.
The upstream API answers an unknown channel with an empty 200, not an error, so this pinned list is the only reliable statement of which channels exist.
The app renders some channels with a generic layout; the channel id is what matters for data, not the layout hint.

Sampled response

Request, 26 Oct 2026: GET /dramabox/channels
Items in channels: 8
Fields filled in every checked item: 2

Field	Filled in, of 8 checked
id	8
name	8

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/dramabox/channels" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "channels": [
      {
        "id": 155,
        "name": "Popular"
      },
      {
        "id": 41,
        "name": "New"
      },
      {
        "id": 89,
        "name": "Rankings"
      },
      {
        "id": 141,
        "name": "Categories"
      },
      {
        "id": 290,
        "name": "Anime"
      },
      {
        "id": 314,
        "name": "Live-Action"
      },
      {
        "id": 291,
        "name": "VIP"
      },
      {
        "id": 13,
        "name": "Original+"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/dramabox.channelsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	dramabox.ChannelsResponse	No
data.channels	array	No
data.channels[].id	integer	No
data.channels[].name	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/dramabox/channels" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More DramaBox endpoint docs DramaBox Short Drama API DramaBox Genre Browse API documentation List DramaBox category filters API documentation Browse DramaBox titles by category API documentation DramaBox Drama Details API documentation List DramaBox genres API documentation DramaBox Home Shelves API documentation

Open in Playground Back to group

Docs menu

DramaBox API endpoint

List DramaBox theater channels API

GETapiKey1 credit/requestDramaBoxdramabox.channelsResponseDoc/dramabox/channels

Endpoint facts

Method: GET
API path: /dramabox/channels
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: DramaBox
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/dramabox.channelsResponseDoc

DramaBox Short Drama API Try List DramaBox theater channels API in Playground DramaBox API documentation

How this endpoint behaves

Returns the DramaBox app's 8 theater channels. This is the closed value space for dramabox-theater's channel parameter.

This endpoint reads DramaBox's Android app API rather than its website pages, device-free. Only public catalog metadata is read; no playable video is returned.

Query parameters: none.

Channel values for dramabox-theater (the lowercase name), with the app's display name and the upstream channel id it maps to:

popular — Popular (155)
new — New (41)
rankings — Rankings (89)
categories — Categories (141)
anime — Anime (290)
live-action — Live-Action (314)
vip — VIP (291)
original — Original+ (13)

Notable response behavior:

id is the app's own channel id; pass the lowercase name as channel to dramabox-theater.
The upstream API answers an unknown channel with an empty 200, not an error, so this pinned list is the only reliable statement of which channels exist.
The app renders some channels with a generic layout; the channel id is what matters for data, not the layout hint.

Sampled response

Request, 26 Oct 2026: GET /dramabox/channels
Items in channels: 8
Fields filled in every checked item: 2

Field	Filled in, of 8 checked
id	8
name	8

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/dramabox/channels" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "channels": [
      {
        "id": 155,
        "name": "Popular"
      },
      {
        "id": 41,
        "name": "New"
      },
      {
        "id": 89,
        "name": "Rankings"
      },
      {
        "id": 141,
        "name": "Categories"
      },
      {
        "id": 290,
        "name": "Anime"
      },
      {
        "id": 314,
        "name": "Live-Action"
      },
      {
        "id": 291,
        "name": "VIP"
      },
      {
        "id": 13,
        "name": "Original+"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/dramabox.channelsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	dramabox.ChannelsResponse	No
data.channels	array	No
data.channels[].id	integer	No
data.channels[].name	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/dramabox/channels" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

List DramaBox theater channels API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

List DramaBox theater channels API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related