x/
check-follow

查询一个 X 账号是否关注了另外最多 100 个账号、对方是否回关,每一对用户名都返回 is_following、is_followed_by 和 is_mutual。

Twitter Follow Checker API

双向关注
每次最多 100 对
互关标记
每条结果 0.7 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Twitter Follow Checker

X(原 Twitter)上的关注是从一个账号指向另一个账号的单向连接,所以任意两个账号只会处于四种状态之一:互不关注、前者关注后者、后者关注前者,或者互相关注。弄清一对账号处在哪种状态,就能回答很多日常问题,比如抽奖参与者有没有关注品牌、合作方是否已经回关,以及一批创作者之间的联系有多紧密。

Twitter Follow Checker API 主要特性

  • 一个账号对比最多 100 个账号把要查的账号填进 username,把最多 100 个账号填进 usernames,每一对单独返回一行,带有 source_username 和 target_username。
  • 双向关注与互关结果同在一行is_following 表示 username 是否关注了对方,is_followed_by 表示对方是否回关,两者都成立时 is_mutual 为 true。
  • 账号对主键与主页链接id 的格式是 source_username:target_username,url 指向对方主页,方便和你自己的名单关联,也能一键打开。

Twitter Follow Checker API 参数

参数必填描述
username必填要查询的 X 账号,会与 usernames 中的每个账号逐一对比。
usernames必填与 username 对比的 X 用户名,最多 100 个,每个账号返回一行对应结果。

如何使用 Twitter Follow Checker API

提交一个账号和要对比的账号列表,然后逐行读取每一对的关注关系。

  1. 向 /v1/x/check-follow 发送 {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}。
  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/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"elonmusk","usernames":["SpaceX","NASA"]}'

# is_following:elonmusk 关注了对方;is_followed_by:对方回关了 elonmusk。

Twitter Follow Checker API 最佳使用场景

  • 核实抽奖参与者是否满足关注要求: 把品牌账号填进 username,把最多 100 位参与者填进 usernames,保留 is_followed_by 为 true 的参与者。
  • 找出还没回关你的合作方: 用你的账号对比你关注的创作者或品牌,列出 is_following 为 true、is_followed_by 为 false 的那些账号对。
  • 梳理一批创作者之间的关注网络: 让每位成员轮流作为 username,与组内其他人对比,再用 is_mutual 画出谁和谁互相关注。
  • 观察关键账号关注了哪些竞品品牌: 用某位高管或记者的账号对比一组竞品账号,隔一段时间再查一次,看 is_following 何时发生变化。

Twitter Follow Checker API 使用建议

  • 名单超过 100 个时,先去重,再按每批 100 个拆分,最后用 id 合并结果。
  • 没有返回对应行的账号记为“未核实”,与结果为 false 的账号对分开存放;只有找到的账号才会产生结果行。
  • 每一对结果连同 collected_at 一起保存,之后重新查询同一批账号,对比前后结果就能看出新增关注和取消关注。

除了 Twitter Follow Checker 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 Community API — 通过社区链接读取主题说明、成员数量、规则和加入政策。
  • X Account Location API — 查询账号所在的国家或地区、连接 X 的方式、注册时间和改名次数。

探索其他平台

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

Twitter Follow Checker API — 常见问题

Twitter Follow Checker API 是一个用于仅凭用户名查询一个 X 账号与另外最多 100 个账号之间关注关系的 API。每一对账号都会返回前者是否关注后者、是否被回关,以及是否互相关注。

把第一个账号填进 username,第二个填进 usernames。is_following 表示前者是否关注了后者,同一行的 is_followed_by 则回答反方向的问题。

把你自己的账号填进 username,对方的填进 usernames。is_followed_by 为 true 就说明对方关注了你,一个任务最多可以查 100 个账号。

看 is_mutual。只有双方都关注了对方时,它才是 true。

username 填一个账号,usernames 最多填 100 个,每一对返回一行。名单更长时分成多个任务提交。

查询针对的是公开账号,按用户名进行。受保护账号在 X 上隐藏了关注列表,涉及它们的账号对无法确认。

这个接口做不到,它只返回你提交的那些账号对。完整名单请使用 X Following List API 或 X Followers List API。