x/
article

通过发布长文的帖子链接读取 X Articles 全文,返回标题、时间线预览文字、封面图、作者以及点赞、回复、引用和浏览数,正文段落之间的空行原样保留。

X Articles API

帖子链接输入
长文完整正文
标题、预览与封面
每条结果 0.7 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

X Articles

X Articles(不少人仍习惯叫它 Twitter 文章或推特长文)是 Premium 订阅用户发布的长篇帖子,带有标题、封面图和排版正文,在时间线上以一段预览文字出现,也像普通帖子一样累积点赞、回复、引用和浏览。把标题、预览和全文作为文本,与这些数据放在一起,就能存档长篇内容、做摘要或分类,并比较作者的长文和普通帖子各自表现如何。

X Articles API 主要特性

  • 用帖子链接定位长文提交一个或多个发布长文的推文链接,格式为 x.com/{username}/status/{post_id},每篇长文返回一行,其中的 id 和 url 对应发布它的那条帖子。
  • 纯文本形式的完整正文text 是整篇长文的正文,段落之间以空行分隔,可以直接按段拆开,交给阅读器、检索系统或大语言模型。
  • 标题、预览文字和封面图title、summary(X 在时间线上显示的预览文字)和 cover_url,对应读者在信息流里第一眼看到的样子。
  • 作者与互动数据author 包含账号名、显示名称、头像和认证标记,metrics 包含点赞、回复、引用和浏览数,published_at 记录长文的发布时间。

X Articles API 参数

参数必填描述
urls必填一个或多个 X 帖子链接,格式为 /{username}/status/{post_id},每个链接指向发布长文的那条帖子。

如何使用 X Articles API

提交发布长文的帖子链接,每篇长文读取一行结果。

  1. 向 /v1/x/article 发送 {"urls": ["https://x.com/USDOL/status/2119796255089947070"]}。
  2. 轮询 GET /v1/tasks/{task_id},等任务 status 显示为 succeeded。
  3. 从 results.items 读取长文;has_more 为 true 时,带上 results.next_cursor 读取下一页。
curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'

# text 是整篇长文,段落之间以空行分隔。

X Articles API 最佳使用场景

  • 存档作者的长篇内容: 为每篇长文保存 title、text、cover_url、published_at 和 url,留下一份可检索的副本,记录某个账号发过的全部长文。
  • 用大语言模型给长文做摘要: 按空行把 text 拆成段落,连同 title 一起交给摘要工具或大语言模型,把长篇内容压缩成简报。
  • 对比长文和普通帖子的表现: 把作者长文的 views_count、likes_count 和 quotes_count 与其普通帖子的同类数据放在一起,看受众更愿意阅读和转述哪种形式。
  • 跟踪长文发布后的表现: 按固定间隔重复请求同一个链接,记录 published_at 之后几天里浏览、回复和引用数的增长。
  • 原文引用公告内容: 政府机构、企业或创始人用长文发布公告时,从 text 中摘取原话,并附上 url 和 published_at 作为出处。

X Articles API 使用建议

  • 拿不准哪些帖子是长文时,可以放在同一批提交:只有长文返回结果并计费,整批都是普通帖子时任务失败并全额退款。
  • 预览和卡片用 summary,阅读页用 text;summary 重复了正文开头几行,两者拼接会让这段内容出现两次。
  • 以 id(发布长文的帖子 ID)为键保存长文,再次采集同一篇时直接更新已存的互动数据。
  • 在看板里展示长文互动时,把 metrics.comments_count 记作这条长文帖子收到的回复数。

除了 X Articles API,需要其他类型的 X 公开数据时,可以使用以下 API。

  • Twitter Tweet Scraper API — 从 x.com 或 twitter.com status URL 获取公开帖子正文、作者、互动、媒体、标签、提及和会话关系。
  • Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
  • Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标,并排除回复。
  • X Post Quotes API — 按已知 status URL 采集公开引用帖,返回评论正文、作者、互动、媒体、时间和来源帖子上下文。
  • X Post Replies API — 从 X 帖子 URL 采集公开回复,支持选择排序,并返回回复正文、作者、可见互动、媒体和父帖信息。
  • Twitter Mentions API — 采集提及指定账号的公开帖子。

探索其他平台

还可以将 X 数据与其他已支持社交平台的公开数据结合使用。

X Articles API — 常见问题

X Articles API 是一个用于根据发布长文的帖子链接读取 X 长文(带标题和封面图的长篇帖子)的 API。它返回标题、时间线预览文字、完整正文、封面图链接、作者,以及点赞、回复、引用和浏览数。

X Articles 是 Premium 订阅用户可以在 X 上发布的长篇帖子,带有标题、封面图和排版正文。它在时间线上显示为一条带简短预览的帖子,读者点开后阅读全文。

提交发布这篇长文的帖子链接,格式为 x.com/{username}/status/{post_id}。urls 里可以一次放多个链接,每篇长文单独返回一行。

这条帖子不返回结果,也不扣积分,同一请求里的其他长文照常返回。如果所有链接都不是长文,任务失败并全额退款。

封面图在 cover_url 中返回。正文中插入的图片不返回,text 只包含文字内容。

可以。text 是纯文本形式的完整正文,段落之间以空行分隔,可以直接存成 .txt 文件,也可以作为 Markdown 段落使用,再把 title 加在最前面作为标题。