Docs menu

DramaBox API endpoint

List DramaBox genres API

Returns the genres DramaBox's browse accepts (Romance, Werewolves, Revenge, Billionaire, ...) as ids and names, read live from DramaBox. Pass a genre id to dramabox-browse. Only public catalog metadata is read; no playable video is returned.

GETapiKey3 credits/requestDramaBoxdramabox.genresResponseDoc/dramabox/genres

Endpoint facts

Method: GET
API path: /dramabox/genres
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: DramaBox
Response schema: #/definitions/dramabox.genresResponseDoc

DramaBox Short Drama API Try List DramaBox genres API in Playground DramaBox API documentation

How this endpoint behaves

Query parameters:

language: optional site locale: en, ko, zhHans, zh, es, ja, de, in (Indonesian), th, tl, pt, fr, ar or it. Defaults to en. Genre names are translated; ids are the same in every locale.

Notable response behavior:

Each genre has a numeric id and a name. The "all" pseudo-genre is not listed; omit genre_id (or pass 0) in dramabox-browse to browse everything.
The list is the site's own and can grow, which is why it is read live instead of being fixed in this documentation.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "language": "en",
    "genres": [
      {
        "id": 534,
        "name": "Werewolves"
      },
      {
        "id": 271,
        "name": "Avenge"
      },
      {
        "id": 189,
        "name": "Divine Tycoon"
      },
      {
        "id": 253,
        "name": "Love Triangle"
      }
    ]
  }
}

Sampled response

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

Field	Filled in, of 54 checked	Values in the sample
id	54
name	54	“Werewolves” and 53 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
language	string	No	en	Site locale, one of: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it (in is Indonesian); defaults to en. Each locale has its own title library Allowed values: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it.	ja
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/dramabox/genres?language=en" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "language": "en",
    "genres": [
      {
        "id": 534,
        "name": "Werewolves"
      },
      {
        "id": 271,
        "name": "Avenge"
      },
      {
        "id": 189,
        "name": "Divine Tycoon"
      },
      {
        "id": 253,
        "name": "Love Triangle"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/dramabox.genresResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	dramabox.GenresResponse	No
data.genres	array	No
data.genres[].id	integer	No
data.genres[].name	string	No
data.language	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/genres?language=en" \
  -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 List DramaBox theater channels API documentation DramaBox Drama Details API documentation DramaBox Home Shelves API documentation

Open in Playground Back to group

Docs menu

DramaBox API endpoint

List DramaBox genres API

GETapiKey3 credits/requestDramaBoxdramabox.genresResponseDoc/dramabox/genres

Endpoint facts

Method: GET
API path: /dramabox/genres
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: DramaBox
Response schema: #/definitions/dramabox.genresResponseDoc

DramaBox Short Drama API Try List DramaBox genres API in Playground DramaBox API documentation

How this endpoint behaves

Query parameters:

language: optional site locale: en, ko, zhHans, zh, es, ja, de, in (Indonesian), th, tl, pt, fr, ar or it. Defaults to en. Genre names are translated; ids are the same in every locale.

Notable response behavior:

Each genre has a numeric id and a name. The "all" pseudo-genre is not listed; omit genre_id (or pass 0) in dramabox-browse to browse everything.
The list is the site's own and can grow, which is why it is read live instead of being fixed in this documentation.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "language": "en",
    "genres": [
      {
        "id": 534,
        "name": "Werewolves"
      },
      {
        "id": 271,
        "name": "Avenge"
      },
      {
        "id": 189,
        "name": "Divine Tycoon"
      },
      {
        "id": 253,
        "name": "Love Triangle"
      }
    ]
  }
}

Sampled response

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

Field	Filled in, of 54 checked	Values in the sample
id	54
name	54	“Werewolves” and 53 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
language	string	No	en	Site locale, one of: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it (in is Indonesian); defaults to en. Each locale has its own title library Allowed values: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it.	ja
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/dramabox/genres?language=en" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "language": "en",
    "genres": [
      {
        "id": 534,
        "name": "Werewolves"
      },
      {
        "id": 271,
        "name": "Avenge"
      },
      {
        "id": 189,
        "name": "Divine Tycoon"
      },
      {
        "id": 253,
        "name": "Love Triangle"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/dramabox.genresResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	dramabox.GenresResponse	No
data.genres	array	No
data.genres[].id	integer	No
data.genres[].name	string	No
data.language	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/genres?language=en" \
  -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 genres 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 genres API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related