开发者 · 今日头条 API
今日头条 API:一条头条链接,返回 AI 能直接用的文字
简单说:不用申请开放平台、不用写爬虫、不用登录。发一条头条文章或视频链接,返回正文全文、每张图的文字、视频逐字稿和要点,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://www.toutiao.com/article/7709705250554266155/", "format": "json"}'页面要在浏览器里读,所以通常先返回 202 和 poll_url,约 15 秒后 GET 它取结果(同样的 POST 再发一次也行,只扣一次费)。
返回什么
一条头条链接,五样东西
| 文章 | 标题、作者(头条号)、发布日期、正文全文 |
| 配图 | 每张图的描述 + 图上文字(OCR) |
| 视频 | 口播逐字稿,带时间;完整深度再加画面上的字;时长 |
| 要点 | 每条附原文引用,代码逐字核对 |
| 读取回执 | 读到了什么、没读到什么;从分享链接读时写明实际请求的是哪个地址 |
线上实测(2026-11-20):一篇带 6 张配图的文章,返回标题、作者、发布日期、正文全文、6 张图的描述和图上文字、14 条要点,1 积分; 一条 4 分 15 秒的视频,返回 40 段带时间的口播逐字稿(到 4:12)和 7 条要点,只要逐字稿 4 积分。
Agent 里用
Claude Code / Cursor:MCP 一行接入
claude mcp add --transport http linkdigest \ https://linkdigest.dev/mcp \ --header "Authorization: Bearer ld_live_..."
常见问题
- 要申请头条的开放平台吗?
- 不用。这里不是头条官方接口,也不代替它发文、管理头条号。它做一件事:你给一条公开的头条文章或视频链接,返回 AI 能直接用的文字。一个 API Key 就能调用。
- 和自己写爬虫比有什么区别?
- 头条的文章页要在浏览器里执行脚本才出现内容。2026-11-20 实测直接请求一篇文章的地址:返回 72,914 字节,可见文字 0 个。自己做要起无头浏览器、解析页面里的数据,视频还要再接语音识别,图上的字要再接 OCR。这里一次调用把这些都做完。
- 支持哪些头条链接?
- www.toutiao.com/article/<编号>/ 和 /video/<编号>/,以及 App 分享出来的 m.toutiao.com/group/<编号>/、/item/<编号>/。头条的 robots.txt 不允许程序访问 /group/ 和 /item/,所以分享链接只用来取编号,实际请求的是它允许的 /article/<编号>/,返回里会写明。同一篇内容不同写法认成同一条,读过再读不扣费。
- 什么读不了?
- 微头条(/w/)、专栏和直播页目前不读,会返回明确的错误,不扣费。已删除或还在审核的内容也读不了。评论不读。
- 怎么收费?
- 按用量:文章 1 积分起(约 ¥0.144),1 分钟视频 2 积分,长视频可以只要逐字稿(depth: "transcript",每开始 2 分钟 1 积分)。读过的链接再读 0 积分,读不出来不扣费。注册送 10 积分,之后支付宝 ¥9.9 买 50 积分,一次性、不订阅、不过期。
不用注册先试一条;注册送 10 积分,不用绑卡。支持的平台上有链接读不出来,就是一个值得报告的 bug。