Short Drama Data API · Short Drama Data

JSON endpoints

All endpoints are read-only and return published data only. Include the page URL, ranking date and methodology link when citing results.

GET https://www.shortdramadata.com/api/v1/rankings/paid?limit=20
GET https://www.shortdramadata.com/api/v1/rankings/free?date=2026-08-20
GET https://www.shortdramadata.com/api/v1/apps/paid/dramabox
GET https://www.shortdramadata.com/api/v1/apps/paid/dramabox/history?window=30
GET https://www.shortdramadata.com/api/v1/apps/paid/dramabox/history?type=country&country=US
GET https://www.shortdramadata.com/api/v1/hot?market=paid&lang=en&limit=50
GET https://www.shortdramadata.com/api/v1/methodology
GET https://www.shortdramadata.com/api/v1/status

MCP tool mapping

For MCP clients, expose these read-only tools and call the matching JSON endpoint from your MCP server:

get_paid_app_rankings -> /api/v1/rankings/paid
get_free_app_rankings -> /api/v1/rankings/free
get_app_detail -> /api/v1/apps/{market}/{slug}
get_app_rank_history -> /api/v1/apps/{market}/{slug}/history
get_country_rank_history -> /api/v1/apps/{market}/{slug}/history?type=country
get_hot_dramas -> /api/v1/hot
get_methodology -> /api/v1/methodology

Example

curl "https://www.shortdramadata.com/api/v1/rankings/paid?limit=5"

Attribution

The API is open for public reading. When you quote, display, repost or analyze the data, please keep the Short Drama Data name, source URL, ranking date and methodology link. Each JSON response includes attribution fields for this purpose.

Single responses are capped to keep the public service stable.

阅读中文版 ->