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
提交发布长文的帖子链接,每篇长文读取一行结果。
- 向 /v1/x/article 发送 {"urls": ["https://x.com/USDOL/status/2119796255089947070"]}。
- 轮询 GET /v1/tasks/{task_id},等任务 status 显示为 succeeded。
- 从 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 记作这条长文帖子收到的回复数。
相关 API
除了 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 — 采集提及指定账号的公开帖子。
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API