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
提交列表链接,等任务完成后分页读取时间线。
- 向 /v1/x/list-posts 发送 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 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 采集同一个列表。
相关 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 — 把列表成员导出为完整的主页资料,含简介、位置和各项计数。
- Twitter Profile Scraper 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
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API