API Documentation

Explore endpoints, parameters, and examples

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer sk-your-token-here

https://api.shortdrama.com

GET/api/v1/search

Search for dramas across platforms

Name	Type	Required	Description
q	string	Required	Search query
platform	string	Optional	Platform ID (omit for all)
page	number	Optional	Page number (default: 1)
limit	number	Optional	Results per page (default: 20, max: 100)

curl -X GET "https://api.shortdrama.com/api/v1/search?q=love&platform=dramabox" -H "Authorization: Bearer YOUR_TOKEN"

GET/api/v1/drama/:id

Get detailed information about a drama

Name	Type	Required	Description
id	string	Required	Drama ID (in path)
platform	string	Required	Platform ID

curl -X GET "https://api.shortdrama.com/api/v1/drama/dramabox-drama-1?platform=dramabox" -H "Authorization: Bearer YOUR_TOKEN"

GET/api/v1/drama/:id/episodes

Get episode list for a drama

Name	Type	Required	Description
id	string	Required	Drama ID (in path)
platform	string	Required	Platform ID
page	number	Optional	Page number

curl -X GET "https://api.shortdrama.com/api/v1/drama/dramabox-drama-1/episodes?platform=dramabox" -H "Authorization: Bearer YOUR_TOKEN"

GET/api/v1/episode/:id

Get streaming links for an episode

Name	Type	Required	Description
id	string	Required	Episode ID (in path)
platform	string	Required	Platform ID

curl -X GET "https://api.shortdrama.com/api/v1/episode/dramabox-drama-1-ep-1?platform=dramabox" -H "Authorization: Bearer YOUR_TOKEN"

GET/api/v1/trending

Get trending dramas

Name	Type	Required	Description
platform	string	Optional	Platform ID (omit for all)

curl -X GET "https://api.shortdrama.com/api/v1/trending" -H "Authorization: Bearer YOUR_TOKEN"