x/
list-followers

查看谁订阅了公开 X 列表:提交列表链接,就能拿到每位关注者的简介、位置、认证标记、注册时间,以及粉丝数、关注数和发帖数。

Twitter List Followers API

列表链接输入
列表订阅者
每个列表最多 2,000 个
每条结果 0.7 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Twitter List Followers

Twitter 列表关注者是为了阅读列表成员的推文而订阅这个 X 列表的账号,每位关注者都有公开主页资料,包括简介、位置、认证状态、注册时间,以及粉丝数、关注数和发帖数。关注一个列表,本身就表明想持续了解这个话题,所以这些资料能看出一个细分领域吸引了哪些人,可以用来比较相关列表的读者,也能找到值得就这个话题去接触的人。

Twitter List Followers API 主要特性

  • 任意公开列表的订阅者提交 x.com/i/lists/<id> 链接,返回主动关注每个列表时间线的账号,单个列表最多 2,000 个。
  • 每位关注者是谁每行包含用户名、显示名称、text 中的简介、头像、封面图、网站和 location.name,合起来就能看出一个列表吸引的是哪类人。
  • 影响力、活跃度、账号年龄与认证metrics.followers_count、following_count、posts_count,加上作为注册时间的 published_at 和 is_verified,可以把成熟活跃的关注者和新号、低活跃账号区分开。

Twitter List Followers API 参数

参数必填描述
urls必填一个或多个公开 X 列表链接,格式均为 https://x.com/i/lists/<numeric id>。每个列表的关注者都会采集。
results_limit可选每个列表采集的关注者数,须为 20 的倍数,范围 20 到 2,000,默认 100。

如何使用 Twitter List Followers API

用一个或多个列表链接创建任务,然后分页读取关注每个列表的账号。

  1. 以 POST 方式向 /v1/x/list-followers 发送 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100},记下返回的 task_id。
  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-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# 每条结果都是关注该列表的账号;列表成员请调用 /v1/x/list-members。

Twitter List Followers API 最佳使用场景

  • 看看谁在关注你的列表: 采集你整理的公开列表的关注者,了解谁在读它,以及其中按 followers_count 计受众最大的是哪些人。
  • 描绘一个话题的受众: 读取“气候科技”或“SaaS 创始人”列表关注者的简介和 location.name,概括对这个话题感兴趣的人群。
  • 筛选可以联系的人: 按 text 里的关键词和 followers_count 筛选关注者,挑出已经在关注你所在领域的账号。
  • 比较同类列表的读者: 在一个任务里采集两个同主题列表的关注者,按 id 匹配,找出共同读者和各自独有的读者。
  • 为相似人群定向准备种子: 从一个挑选得当的列表导出关注者的用户名和 id,作为广告工具里相似人群或兴趣定向的种子名单。

Twitter List Followers API 使用建议

  • 用 id 把关注者和 Twitter List Members API 返回的列表成员对上,找出同时关注了列表的成员,以及列表之外的读者。
  • 比较多个列表时,给每个列表设同一个 results_limit,让各自的受众按相同深度采集。
  • 每次采集都保存关注者 id,之后再导出同一个列表,就能看出这段时间新增了哪些关注者。

除了 Twitter List Followers 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 List Tweets API — 按时间从新到旧读取列表时间线,转发帖会标出原作者。
  • Twitter List Members API — 把列表成员导出为完整的主页资料,含简介、位置和各项计数。

探索其他平台

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

Twitter List Followers API — 常见问题

Twitter List Followers API 是一个用于通过列表链接采集公开 X 列表关注者(订阅者)的 API。它返回每位关注者的用户名、名称、简介、位置、网站、认证和私密标记、注册时间,以及粉丝数、关注数和发帖数。

公开列表可以。提交列表链接,每位订阅者都会以一行主页资料返回,每个列表最多 2,000 个。

关注者是为了看列表时间线而订阅它的人;成员是列表创建者添加进去的账号。本 API 返回关注者,成员请用 Twitter List Members API。

不能,它返回的是列表的订阅者。要获取关注某个用户主页的账号,请使用 X Followers List API。

小列表往往只有少数订阅者,结果里就是关注这个列表的全部账号。每返回一位关注者扣 0.7 积分,结果为空不扣积分。