开发者 · 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 积分;读不出内容不收费。

做不到的

接之前先看这几条

  • 一次读一条链接:不搜索,不读回复和引用链,不读某个账号的时间线。
  • 受保护账号、年龄限制内容读不了;X 偶尔对服务器地址限流,读不了时返回 422/504,不扣费。
  • 同一个 Key 还能读小红书、抖音和YouTube。

不支持的

先说做不到的

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

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

常见问题

会被问到的

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。