Short Drama Data 数据调用说明

JSON 接口

所有接口均为只读，只返回已经公开发布的数据。引用结果时建议同时保留页面 URL、排名日期和数据说明链接。

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 工具映射

如果要给 MCP 客户端使用，建议把下面这些 tools 映射到对应 JSON API：

• 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

引用与标识

接口开放给公开读取。引用、展示、转载或二次分析数据时，请保留 Short Drama Data 名称、来源 URL、排名日期和数据说明链接。每个 JSON 返回里也会附带对应的 attribution 字段，方便直接展示。

单次返回数量会做上限控制，主要是为了保持公开服务稳定。

Read in English ->