开发者 · 红果短剧 API · 2026-11-15 起支持
红果短剧 API:一个剧详情链接,返回这部剧的全部公开数据
简单说:发一部剧的详情页链接,返回剧名、简介、标签、集数、评分和评分人数、点赞、收藏、热度、榜单名次、备案号和观众剧评, JSON 或 Markdown,REST 或 MCP 一次调用。可以加剧评洞察,也可以一批剧一起读、出一页对比。不用写爬虫,不读剧集视频。
一次调用
curl 一部剧
curl -X POST https://linkdigest.dev/api/v1/digest \
-H "Authorization: Bearer ld_live_..." \
-H "Content-Type: application/json" \
-d '{"url": "https://hongguoduanju.com/detail?series_id=7704261228037671998", "format": "json"}'返回(2026-11-15 实测,节选):
{
"platform": "hongguo",
"title": "和离后我带女儿横扫魔域第二季",
"author": "红果短剧",
"tags": ["玄幻", "系统", "逆袭", "修真", "异界"],
"caption": "陆清安走出旧日情缘,凭借神秘系统与非凡悟性……\n\n共 521 集 · 网页可看前 5 集 · 评分 9.3(4012 人评分) · 6671万热度 · 漫剧热播榜第6名 · 备案号 ……",
"stats": { "as_of": "2026-11-15", "likes": 5035000, "collects": 1397000 },
"category": ["漫剧热播榜第6名"],
"comments": [
{ "text": "[10 分] 必须十分,评分十分,大赞。第一季新出我就追了,难得的修仙好剧。……", "likes": 343, "posted_at": "2026-11-08" }
]
}这部剧当天已经有人读过,所以这次 0 积分。没人读过的剧第一次读 1 积分,十几秒返回。
返回什么
一部剧,这些字段
| 剧名 · 简介 | title 是剧名;caption 是官网简介,最后一行是这部剧的数字 |
| 数字 | 共几集、网页可看前几集、评分和评分人数、热度、榜单名次、备案号 |
| 互动 | stats:点赞 likes、收藏 collects(读取当天的值,as_of 写着日期) |
| 标签 | tags:红果给这部剧打的题材标签,比如 玄幻 / 系统 / 逆袭 |
| 剧评 | comments:详情页上的观众剧评,每条带打分、点赞数和日期 |
| 榜单 | category:榜单名次,比如「漫剧热播榜第6名」 |
| 洞察(可选) | insight: true:观众夸什么、骂什么,每条附剧评原话,代码逐字核对 |
数据分析
一批剧一起读,出一页对比
curl -X POST https://linkdigest.dev/api/v1/digest/batch \
-H "Authorization: Bearer ld_live_..." \
-H "Content-Type: application/json" \
-d '{"urls": ["https://hongguoduanju.com/detail?series_id=...", "..."],
"insight": true, "synthesis": true}'
# 返回 batch_id,GET /api/v1/digest/batch/{batch_id} 取每部剧的数据和对比对比里有:题材和标签各出现在几部剧、开头钩子、观众认可和吐槽的点,每条带剧评原话。我们用这个读了红果榜单上的剧,结果见红果短剧现在什么题材火。命令行版本是技能 hongguo-drama-research:python3 scripts/rank.py --page ai --top 12 读 AI 剧榜前 12 部。
Agent 里用
Claude Code / Cursor / ChatGPT:MCP 接入后直接贴链接
claude mcp add --transport http linkdigest \ https://linkdigest.dev/mcp \ --header "Authorization: Bearer ld_live_..."
常见问题
- 红果短剧有官方 API 吗?
- 我们在红果官网(hongguoduanju.com,2026-11-15 查看)没有找到面向开发者的公开数据接口。官网每部剧有一个公开的详情页,这个 API 读的就是这一页:你发链接,我们读这一页,返回整理好的 JSON。
- 和自己写爬虫爬红果短剧数据比有什么区别?
- 自己爬要找到页面里藏数据的地方、处理改版、控制频率,还要分清哪些路径能读:红果的 robots.txt 不允许抓播放页(/player/、/series/)。这里只读你发来的剧详情页,按请求读,不做全站批量抓取,不碰播放页;读过的剧谁再读都是 0 积分。
- 能拿到剧集里的台词、逐字稿吗?
- 不能由我们的服务器读:剧集是版权方的作品,播放页也是 robots.txt 不允许的路径。办法是在你自己的浏览器里打开这一集(官网网页能免费看前几集),点 LinkDigest 浏览器插件的「读这个视频」,读出口播逐字稿、画面文字和要点。把播放页链接直接发给 API,会返回这条读法,不扣费。
- 有现成的红果短剧数据集吗?
- 我们不卖数据集,也不囤红果的数据。你挑要研究的剧(比如某个榜单的前 20 部),用批量接口一次读完,得到的就是你自己的数据;加上 synthesis: true 会再出一页对比:题材、标签、观众夸和骂的点,带原话。
- 支持哪些链接?
- 红果官网的剧详情页:hongguoduanju.com/detail?series_id=<数字>。在官网打开一部剧,复制地址栏就是。播放页链接(/player/…)会被如实拒绝并告诉你详情页地址,不扣费。
- 怎么收费?
- 每部剧 1 积分(约 ¥0.144),加剧评洞察 +1;多部剧对比每 10 部 1 积分。前 12 部一起读、带洞察和对比约 26 积分。别人读过的剧 0 积分,读不出来不扣费。注册送 10 积分,之后支付宝 ¥9.9 买 50 积分,一次性、不订阅、不过期。
不用注册先试一条;注册送 10 积分,不用绑卡。支持的平台上有链接读不出来,就是一个值得报告的 bug。