开发者 · 抖音
抖音口播提取 API
传一条抖音链接或分享口令,拿回一个 JSON:口播逐字稿(带时间)、画面上的字幕和文字(带时间)、标题简介、章节、要点(每条附一句原文引用,逐字核对)、 点赞评论收藏数,以及一份「读了多少」的回执。不下载视频,不需要抖音账号。
真实返回 · 节选
一条 2 分 22 秒的口播视频
线上公开结果页:/d/e5775984e47541a447aee272d072cba1。9 段口播逐字稿、72 行画面文字、要点带核对通过的引用;4 积分。文字截短了,其余原样。
{
"platform": "douyin",
"title": "硅谷的AI一人公司这么牛了? 一个人AI创业实现财富自由…",
"author": "第二次用火",
"posted_at": "2026-08-19",
"duration_seconds": 142,
"transcript": [
{ "t": 0.0, "text": "Webflow前二号位CTO布莱恩·周离职后,独自开发了一款名为Ploy的AI产品…" },
{ "t": 16.2, "text": "…" }
],
"on_screen": [{ "t": 2.0, "text": "一个人的AI公司" }, { "t": 9.0, "text": "…" }],
"key_points": ["Webflow前二号位CTO布莱恩·周(Brian Zhou)离职后,独自开发了一款名为Ploy的AI产品。", "…"],
"key_point_support": [{ "point_index": 0, "kind": "transcript", "t": 0.0, "quote": "…", "verified": true }],
"stats": { "likes": …, "comments": …, "collects": …, "shares": … },
"coverage": { "seconds_transcribed": 142, "duration_seconds": 142, "transcript_source": "asr", "not_captured": ["comments not read"] }
}用法
一条 curl,或一行 MCP
curl -X POST https://linkdigest.dev/api/v1/digest \
-H "Authorization: Bearer ld_live_..." \
-H "Content-Type: application/json" \
-d '{"url": "https://v.douyin.com/XXXXXXXX/", "format": "json"}'这条链接是首页示例之一,已经被读过并缓存,所以会直接返回 200, 不扣额度。换成你自己的链接:图文和短帖直接返回;需要下载并转写的视频返回 202 和一个 jobId,用同一个 key 去 GET /api/v1/digest/JOB_ID 取结果。
# 返回 202 时:用同一个 Key 取结果,每次最多等 20 秒 curl "https://linkdigest.dev/api/v1/digest/JOB_ID?wait=20" -H "Authorization: Bearer ld_live_..." # 没有 Key:不带 Authorization,返回摘要(每个地址每天 2 条)
MCP · Claude Code(Cursor、Trae、Cherry Studio、通义灵码见文档)
claude mcp add --transport http linkdigest \ https://linkdigest.dev/mcp \ --header "Authorization: Bearer ld_live_..."
API Key 在 https://linkdigest.dev/app/keys 创建(形如 ld_live_…)。 REST、MCP 各客户端的配置、轮询和返回字段见 中文 API / MCP 文档。
用 OpenClaw / Hermes?装现成的技能:douyin-video-to-text(ClawHub)。想拆解爆款?在请求里加 breakdown: true,见爆款拆解 API。
价格
按分钟计费,折合人民币
基础 1 积分,每开始的 1 分钟 +1。读过的同一条再读 0 积分;读不出内容不收费。
| 一条内容 | 积分 | 折合人民币 |
|---|---|---|
| 1 分钟 | 2 | ¥0.288 |
| 2:22(下面这条) | 4 | ¥0.576 |
| 5 分钟 | 6 | ¥0.864 |
| 10 分钟 | 11 | ¥1.584 |
| 30 分钟(transcript 档) | 16 | ¥2.304 |
| 2:22 + 爆款拆解 | 5 | ¥0.72 |
按加量包折算:$5 = 250 积分,支付宝按人民币结算 ¥36,每积分 ¥0.144。注册送 10 积分(一次性)。 任何人读过的链接再读 0 积分;读不出内容不收费。
做不到的
接之前先看这几条
| 平台 / 类型 | 原因 |
|---|---|
| B站(哔哩哔哩) | 对我们服务器的地址直接返回 HTTP 412,请求到不了视频。需要代理,目前没有。 |
| X 长文(Articles) | 只能拿到首图。普通帖子的图片、视频都能读,长文正文读不到。 |
| 代码已接入,但没有端到端验证过,所以不算支持。 |
常见问题
会被问到的
- 分享口令能直接用吗?
- 能。把抖音 App 里复制的整段分享文案(带 v.douyin.com 短链)原样传进 url 字段,服务端自己把链接挑出来。
- 口播和画面字幕是分开给的吗?
- 分开。transcript 是口播逐字稿(有平台字幕用平台的,没有就语音识别),on_screen 是画面上出现的字和它出现的秒数——两者经常不一样,比如口播说一套、画面打另一套关键词。
- 需要抖音账号或 cookie 吗?
- 不需要。读取在我们的服务器上完成;你只传链接。私密、已删除的视频读不了,返回 422,不扣费。
- 长视频怎么办?
- 每开始的 1 分钟 1 积分。免费和加量包账户单条最长 10 分钟;更长的用 depth=transcript(全程逐字稿 + 稀疏截帧,每 2 分钟 1 积分,最长 60 分钟)。
- 没有 Key 能试吗?
- 能。不带 Key 调用 /api/v1/digest 或 MCP 的 digest_url,返回摘要,每个地址每天 2 条;完整逐字稿需要 Key,注册送 10 积分。
不用注册先试一条;注册送 10 积分,不用绑卡。支持的平台上有链接读不出来,就是一个值得报告的 bug。