开发者 · 红果短剧 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_..."

相关:红果短剧题材榜 · 中文文档 · 数据来源与合规 · English

常见问题

红果短剧有官方 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。