x/
list-members

通过列表链接导出公开 X 列表中的账号,返回每位成员的用户名、简介、位置、网站、认证状态,以及粉丝数、关注数和发帖数。

Twitter List Members API

列表链接输入
列表创建者添加的账号
成员完整资料
每条结果 0.7 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

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

提交要导出的列表链接,任务完成后收取成员资料。

  1. 在 x.com 复制列表链接,向 /v1/x/list-members 发送 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}。
  2. 每隔几秒查询一次 GET /v1/tasks/{task_id},直到状态变为 succeeded。
  3. 保存 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,可以看到谁在关注这个列表。

除了 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 — 按时间从新到旧读取列表时间线,转发帖会标出原作者。

探索其他平台

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

Twitter List Members API — 常见问题

Twitter List Members API 是一个用于通过列表链接导出公开 X 列表成员账号的 API。它为每位成员返回用户名、名称、简介、位置、网站、认证和私密标记、注册时间,以及粉丝数、关注数和发帖数。

在 x.com 复制列表链接放进 urls,设置好 results_limit 后提交,任务完成后读取成员资料;has_more 为 true 时用 next_cursor 继续读取。每位成员都是一条 JSON 记录,可以写入表格或 CRM。

可以。任何公开列表都能凭链接导出,不论是谁创建的。

每个列表最多 2,000 个,通过 results_limit 设置,须为 20 的倍数,默认 100。一次提交多个列表时,这个上限分别作用于每个列表。

每返回一位成员扣 0.7 积分,100 位成员的列表就是 70 积分。结果为空不扣积分。