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
提交用户名,设定每个账号要采集多少位认证粉丝,再分页读取结果。
- 向 /v1/x/verified-followers 发送 {"usernames": ["NASA"], "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/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 里。
相关 API
除了 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 — 查询一个账号是否关注了其他账号,以及对方是否回关。
- 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 List Tweets API
- Twitter List Members 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 Video Transcript API