开发者 · X(推特)
X / 推特帖子提取 API
传一条 x.com 链接,拿回一个 JSON:帖子正文、每张图的描述和图上的字(长推文截图也行)、视频的口播逐字稿和画面文字、要点(每条附一句原文引用,逐字核对)、 点赞转发数,以及一份「读了多少」的回执。不需要 X 账号,不用登录。
真实返回 · 节选
一条正文很短、内容在截图里的帖子
2026-10-08 线上实际读取(Andrej Karpathy 2026-10-02 的公开帖):1 张图读出 90 行文字,13 条要点,其中 11 条的引用核对通过,1 积分。字段如下,文字截短了。
{
"platform": "x",
"author": "Andrej Karpathy (@karpathy)",
"posted_at": "2026-10-02",
"caption": "We'll be spending a lot more time trying to unders…",
"images": [{ "description": "A screenshot of a long text post …", "ocr": "… (90 lines) …" }],
"key_points": ["Karpathy recommends using ASD-STE100, a controlled language specification, to improve LLM output cla…", "…"],
"key_point_support": [{ "point_index": 0, "kind": "image", "image_index": 0, "quote": "…", "verified": true }],
"stats": { "likes": …, "shares": …, "comments": … },
"coverage": { "images_read": 1, "images_total": 1, "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://x.com/user/status/XXXXXXXXXXXXXXX", "format": "json"}'这条链接是首页示例之一,已经被读过并缓存,所以会直接返回 200, 不扣额度。换成你自己的链接:图文和短帖直接返回;需要下载并转写的视频返回 202 和一个 jobId,用同一个 key 去 GET /api/v1/digest/JOB_ID 取结果。
# 没有 Key:不带 Authorization,返回摘要(每个地址每天 2 条)
curl -X POST https://linkdigest.dev/api/v1/digest -H "Content-Type: application/json" -d '{"url": "https://x.com/user/status/XXXXXXXXXXXXXXX"}'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 文档。
价格
按图片数 / 分钟计费,折合人民币
基础 1 积分含 6 张图,每多 6 张 +1;视频每开始的 1 分钟 +1。读过的同一条再读 0 积分;读不出内容不收费。
| 一条内容 | 积分 | 折合人民币 |
|---|---|---|
| 文字帖 / 1 张图(下面这条) | 1 | ¥0.144 |
| 4 张图 | 1 | ¥0.144 |
| 1 张图 + 中文译文 | 2 | ¥0.288 |
| 2 分钟视频帖 | 3 | ¥0.432 |
按加量包折算:$5 = 250 积分,支付宝按人民币结算 ¥36,每积分 ¥0.144。注册送 10 积分(一次性)。 任何人读过的链接再读 0 积分;读不出内容不收费。
做不到的
接之前先看这几条
| 平台 / 类型 | 原因 |
|---|---|
| B站(哔哩哔哩) | 对我们服务器的地址直接返回 HTTP 412,请求到不了视频。需要代理,目前没有。 |
| X 长文(Articles) | 只能拿到首图。普通帖子的图片、视频都能读,长文正文读不到。 |
| 代码已接入,但没有端到端验证过,所以不算支持。 |
常见问题
会被问到的
- X 现在不登录看不了,你们怎么读?
- 用我们的服务器读公开帖子,你只传链接;不需要你的账号、cookie 或 API 权限。受保护账号、已删除的帖子读不了,返回 422,不扣费。
- 长推文的截图能读出来吗?
- 能。很多长内容是以截图发的:下面这条 Karpathy 的帖子正文很短,干货在一张图里,图上读出 90 行文字,13 条要点里 11 条带核对通过的原文引用。
- 视频帖呢?
- 口播走语音识别出逐字稿,画面上的字带时间;按视频每分钟计费。
- 能翻译成中文吗?
- 加 translate_to: "zh-CN",+1 积分,返回标题/正文/要点/图片文字的中文,原文保留。
- 没有 Key 能试吗?
- 能。不带 Key 调用 /api/v1/digest 或 MCP 的 digest_url,返回摘要,每个地址每天 2 条;完整内容需要 Key,注册送 10 积分。
不用注册先试一条;注册送 10 积分,不用绑卡。支持的平台上有链接读不出来,就是一个值得报告的 bug。