开发者 · 抖音

抖音口播提取 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 积分;读不出内容不收费。

做不到的

接之前先看这几条

  • 一次读一条链接:不搜索,不读评论,不读某个账号的全部视频,不下载视频。
  • 语音识别对方言、多人抢话、背景音乐很响的口播会出错;要点旁的引用核对结果(verified)告诉你哪条可信。
  • 抖音会不定期封服务器地址;读不了时返回 422/504,不扣费,/platforms 页有最近一次验证时间。
  • 同一个 Key 还能读小红书视频和公众号文章。

不支持的

先说做不到的

接进去之后才发现读不出来,比现在就知道更糟。以下是明确不支持的,写在这里也写在覆盖表上。

平台 / 类型原因
B站(哔哩哔哩)对我们服务器的地址直接返回 HTTP 412,请求到不了视频。需要代理,目前没有。
X 长文(Articles)只能拿到首图。普通帖子的图片、视频都能读,长文正文读不到。
Instagram代码已接入,但没有端到端验证过,所以不算支持。

常见问题

会被问到的

分享口令能直接用吗?
能。把抖音 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。