Twitter List Members
Twitter 列表成员是 X 列表创建者亲手挑选并加入的账号,每位成员都有公开主页资料,包括名称、简介、位置、网站、认证状态、注册时间,以及粉丝数、关注数和发帖数。挑人这一步已经由业内人士完成,这些资料可以直接当作候选名单,用来找潜在客户、研究达人和补全账号信息,定期留存的快照还能记录一个精选群体的变化。
Twitter List Members API 主要特性
- 凭列表链接拿到精选账号每提交一个 x.com/i/lists/<id> 链接,就返回列表创建者放进去的账号,单个列表最多 2,000 个,手工整理的名单由此变成可以排序和筛选的数据行。
- 每位成员都有完整资料每行包含用户名、显示名称、text 中的简介、头像和封面图、网站以及 location.name,看一行数据就能判断账号是否合适。
- 影响力、活跃度和账号年龄metrics.followers_count、following_count 和 posts_count 反映每位成员的受众规模和发帖量,published_at 是账号注册 X 的日期。
- 认证与私密标记is_verified 和 is_private 分别标出认证成员和受保护账号,方便分组处理。
Twitter List Members API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 以 /i/lists/<numeric id> 结尾的公开 X 列表链接,例如 https://x.com/i/lists/1940592907737845989。每个列表的成员分别返回。 |
results_limit | 可选 | 每个列表最多导出的成员数,取值 20 到 2,000,按 20 递增,默认 100。 |
如何使用 Twitter List Members API
提交要导出的列表链接,任务完成后收取成员资料。
- 在 x.com 复制列表链接,向 /v1/x/list-members 发送 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}。
- 每隔几秒查询一次 GET /v1/tasks/{task_id},直到状态变为 succeeded。
- 保存 results.items 里的成员资料;has_more 为 true 时,用 results.next_cursor 请求下一页。
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# 成员简介在 text 字段,账号注册 X 的日期在 published_at。Twitter List Members API 最佳使用场景
- 把精选列表变成潜在客户名单: 导出“金融科技创始人”或“AI 研究员”这类列表,按简介 text 和 website 留下与你的产品相关的成员,再去联系。
- 给圈内账号排名和分层: 按 metrics.followers_count 排序,再按 is_verified 或 location.name 分组,把头部账号和不同地区的账号区分开。
- 补全 CRM 和线索资料: 以每位成员的账号 id 为键,把用户名、网站、location.name 和简介写入联系人记录。
- 记录列表的增减: 定期导出同一个列表,对比两次结果里的成员 id,看谁被加入、谁被移除。
Twitter List Members API 使用建议
- 跨批次比对成员时用 id,因为用户名可以修改。
- 成员所在地看 location.name;即使显示了地点,city、region 和 country 也可能为 null,按国家分组前先自行解析 location.name。
- 把 results_limit 设成高于列表成员数的下一个 20 的倍数,一个任务就能导出整份列表;只按实际返回的成员计费。
- 同一个列表链接提交给 X List Tweets API,可以读取这些成员发的帖子;提交给 Twitter List Followers API,可以看到谁在关注这个列表。
相关 API
除了 Twitter List Members API,需要其他类型的 X 公开数据时,可以使用以下 API。
- Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
- X Followers List API — 按一个或多个 X 用户名采集公开关注者账号身份与可见资料指标。
- X Following List API — 采集 X 公开账号关注的个人资料,包括身份、简介、账号状态、可见计数和来源 username。
- X Post Retweeters API — 采集转发已知 X 或 Twitter status URL 的公开账号,并在整个任务中按账号去重后返回标准化主页记录。
- X Account Location API — 查询账号所在的国家或地区、连接 X 的方式、注册时间和改名次数。
- X List Tweets API — 按时间从新到旧读取列表时间线,转发帖会标出原作者。
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context 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