x/
list-posts

通过列表链接采集公开 X 列表时间线上的最新帖子和转发,按从新到旧排列,每条都带正文、作者、点赞、浏览量、图片视频和转发标记。

X List Tweets API

列表链接输入
转发帖带标记
最新帖子在前
每条结果 0.7 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

X List Tweets

X 列表时间线汇集了某人放进同一个列表的账号所发的推文和转发,每条都有正文、作者、点赞、评论、转发和浏览数,以及附带的图片或视频、话题标签和 @ 提及。把这些帖子放在一起读,就能跟上一组记者、创业者或竞争对手正在谈论的话题,看出哪些成员的帖子互动最多,以及这群人反复转发的是谁的内容。

X List Tweets API 主要特性

  • 按链接读取任意公开列表提交一个或多个 x.com/i/lists/<id> 链接,每个列表时间线上的推文按从新到旧返回,单个列表最多 2,000 条。
  • 转发帖带标记,原作者单独列出is_repost 标出每一条转发;author 始终是转发它的列表成员,reposted_author 和 reposted_post_id 则指向原作者和原帖。
  • 每条帖子的互动与媒体metrics 给出点赞、评论、转发和浏览数,media 列出每张图片或每段视频的链接、缩略图、宽度和高度。
  • 话题标签与提及各自成列hashtags 和 mentions 以独立数组返回,列表在聊哪些话题、成员常 @ 哪些账号,直接按字段就能统计。

X List Tweets API 参数

参数必填描述
urls必填公开 X 列表链接,格式为 https://x.com/i/lists/<numeric id>。每个列表的时间线分别采集。
results_limit可选每个列表采集的帖子数,取值 20 到 2,000,须为 20 的倍数,默认 100。

如何使用 X List Tweets API

提交列表链接,等任务完成后分页读取时间线。

  1. 向 /v1/x/list-posts 发送 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}。
  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/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# 转发帖的 is_repost 为 true,原作者在 reposted_author 中。

X List Tweets API 最佳使用场景

  • 通过列表跟进一个报道领域: 每天早上拉取记者或分析师列表的时间线,结合 text、author 和 published_at,了解这组人自上次采集以来聊了什么。
  • 找出圈内反响最大的帖子: 只保留 is_repost 为 false 的原创帖,按 views_count 和 likes_count 排序,看哪些成员的动态最受关注。
  • 统计这群人在帮谁扩散: 统计转发帖里的 reposted_author.username,看列表最常转发哪些外部账号,又在互相转发哪些成员。
  • 把竞品动态汇总到一条信息流: 把竞品品牌账号放进同一个列表,采集它的时间线,一并拿到它们的发布帖、正文链接和附带的图片视频。
  • 为一个圈子整理话题数据集: 把列表帖子里的 hashtags 和 mentions 按 published_at 分组,观察这个圈子在不同时间讨论的话题和常被提及的账号。

X List Tweets API 使用建议

  • 按互动给成员排名前,先按 is_repost 过滤,因为转发帖带的是原帖的点赞和浏览数。
  • 多位成员转发同一条帖子时,按 reposted_post_id 去重,同一条原帖只算一次。
  • 热闹的列表时间线里转发可能占大头,需要足够多的原创帖时就调高 results_limit,给过滤留出余量。
  • 转发帖的 text 以“RT @用户名:”开头,mentions 里也会出现这位原作者;统计关键词和提及前,先剔除转发或去掉这个前缀。
  • 定期采集时,只保留 id 在库里还没有的帖子,因为从新到旧的时间线会和上一次的结果重叠。
  • 想知道这条时间线来自哪些账号,包括很少发帖的成员,就用 Twitter List Members API 采集同一个列表。

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

  • Twitter Tweet Scraper API — 从 x.com 或 twitter.com status URL 获取公开帖子正文、作者、互动、媒体、标签、提及和会话关系。
  • Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标,并排除回复。
  • X Post Quotes API — 按已知 status URL 采集公开引用帖,返回评论正文、作者、互动、媒体、时间和来源帖子上下文。
  • X Post Replies API — 从 X 帖子 URL 采集公开回复,支持选择排序,并返回回复正文、作者、可见互动、媒体和父帖信息。
  • Twitter Mentions API — 采集提及指定账号的公开帖子。
  • Twitter List Members API — 把列表成员导出为完整的主页资料,含简介、位置和各项计数。

探索其他平台

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

X List Tweets API — 常见问题

X List Tweets API 是一个用于通过列表链接采集公开 X 列表时间线的 API。它返回每条帖子或转发的正文、作者、点赞、评论、转发、浏览数、媒体、话题标签、提及和转发来源。

在 x.com 打开列表,复制形如 https://x.com/i/lists/1940592907737845989 的链接,放进 urls 提交即可。帖子按从新到旧返回,和列表自己的时间线顺序一致。

就是列表链接里 /i/lists/ 后面的那串数字。提交时在 urls 里填写完整链接。

会。列表成员的转发也会返回,并用 is_repost 标记,原帖 ID 在 reposted_post_id,原作者在 reposted_author。只想要原创帖时,按 is_repost 过滤即可。

链接指向的列表不存在时,结果为空;任务仍然成功,不扣积分。请检查 /i/lists/ 后面的数字是否完整。

可以。把每个列表链接都放进 urls。results_limit 按列表分别计算,三个列表各设 100,最多返回 300 条帖子。