x/
verified-followers

按用户名采集关注某个 X 账号的认证账号,返回每位粉丝的用户名、显示名称、主页链接、头像和注册时间,每个账号最多 2,000 条。

X Verified Followers API

认证关注者标签页
每个账号最多 2,000 条
粉丝注册时间
每条结果 0.7 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

X Verified Followers

X 认证粉丝,是一个账号的关注者中带认证标识的那一部分,就列在主页的“认证关注者”标签页里,每位粉丝都带有用户名、显示名称、头像和加入 X 的日期。这份名单主要由创作者、品牌和付费用户组成,能看出哪些有分量的账号已经在关注某个主页,也是做建联、竞品研究和受众质量评估时一份精炼的样本。

X Verified Followers API 主要特性

  • 来自“认证关注者”标签页结果与 X 主页“认证关注者”标签页中的名单一致,返回的每位粉丝 is_verified 都是 true。
  • 每行同时标明双方账号actor 是你查询的账号,related_actor 是那位认证粉丝,relationship 为 follower,一次查多个用户名时也能按账号分清每一行。
  • 粉丝身份与主页链接related_actor 给出每位粉丝的 id、username、显示名称、主页 url 和 avatar_url,足够打开、筛选或导出这个账号。
  • 每位粉丝的注册时间每行的 published_at 是这位认证粉丝加入 X 的日期,能把老账号和新注册的账号区分开。
  • 每个用户名 20 到 2,000 条results_limit 按用户名分别计算,以 20 为步长,既能先取 20 条小样本,也能一次拿到 2,000 位认证粉丝。

X Verified Followers API 参数

参数必填描述
usernames必填要采集认证粉丝的 X 用户名,每个账号分别采集。
results_limit可选每个用户名返回的认证粉丝数量,须为 20 的倍数,取值 20 到 2,000,默认 100。

如何使用 X Verified Followers API

提交用户名,设定每个账号要采集多少位认证粉丝,再分页读取结果。

  1. 向 /v1/x/verified-followers 发送 {"usernames": ["NASA"], "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/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["NASA"],"results_limit":100}'

# related_actor 是认证粉丝,actor 是你查询的账号。

X Verified Followers API 最佳使用场景

  • 从竞品的认证粉丝里整理建联名单: 采集竞品账号的认证粉丝,导出 related_actor.username 和 url,联系那些已经在关注这个领域的创作者、品牌和付费用户。
  • 找出只关注竞品的认证账号: 在一个任务里同时采集你自己和竞品的认证粉丝,保留只出现在竞品名单里的 related_actor.id。
  • 对比多个主页的认证受众: 一次提交多个用户名,比较各自的结果条数和重合的 related_actor.id,看哪些主页吸引的是同一批认证账号。
  • 发现集中新注册的认证粉丝: 把一个主页的认证粉丝按 published_at 排序,看它的认证受众主要是老账号,还是最近才加入 X 的账号。

X Verified Followers API 使用建议

  • 先把 results_limit 设为 20,确认这个主页有值得采集的认证受众后再调高;每返回一位粉丝扣 0.7 积分。
  • 某个用户名返回的条数正好等于 results_limit 时,它的认证粉丝可能还有更多,可以把上限调高到 2,000 看得更全。
  • 用 related_actor.id 作为粉丝主键,按 collected_at 对比前后两次结果,就能看出上次之后新增了哪些认证账号。
  • 从 actor.username 读取你查询的账号;actor 的其他字段可能为空,粉丝的详细信息在 related_actor 里。

除了 X Verified 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 Account Location API — 查询账号所在的国家或地区、连接 X 的方式、注册时间和改名次数。
  • Twitter Follow Checker API — 查询一个账号是否关注了其他账号,以及对方是否回关。

探索其他平台

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

X Verified Followers API — 常见问题

X Verified Followers API 是一个用于按用户名采集 X 账号带认证标识的粉丝的 API,每个账号最多 2,000 位。每行结果把你查询的账号与一位认证粉丝关联起来,并附上该粉丝的 id、用户名、显示名称、主页链接、头像和注册时间。

X 把他们列在主页关注者里的“认证关注者”标签页下。在这里提交该用户名,就能以结构化行的形式拿到同一份名单,方便排序、筛选和导出。

在 X 上带认证标识的关注者,也就是 X 列在“认证关注者”标签页里的账号。返回的每位粉丝 related_actor.is_verified 都是 true。

可以,数一下该用户名返回的行数即可。把 results_limit 设为 2,000 能看到最多;认证粉丝超过这个数的账号会返回 2,000 行,这时把它当作下限来看。

不会。每行只有粉丝的 id、用户名、显示名称、主页链接、头像、认证标记和注册时间。需要粉丝数或简介时,把这些用户名交给 Twitter Profile Scraper API 查询。

不是。这里的 published_at 是这位认证粉丝加入 X 的日期,关注发生的时间不在结果里。