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
提交一个账号和要对比的账号列表,然后逐行读取每一对的关注关系。
- 向 /v1/x/check-follow 发送 {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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 一起保存,之后重新查询同一批账号,对比前后结果就能看出新增关注和取消关注。
相关 API
除了 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 的方式、注册时间和改名次数。
- 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 Posts API
- X Thread Context API
- X Verified Followers 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