x/
user-about

按用户名查询 X 为账号标注的所在国家或地区,同时返回账号连接 X 的方式、注册时间、改名次数和所属机构徽章。

X Account Location API

账号所在地
连接方式
批量用户名
每条结果 0.7 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

X Account Location

X 的“关于此账号”面板是挂在每个主页上的一份简短档案,写明账号所在的国家或地区、通过哪个应用商店、App 或网页端连接 X、何时注册、改过几次用户名,以及隶属于哪个机构。把这几项放在一起看,就能判断账号的实际运营地是否与它发布的内容相符,在合作前核查达人,或者找出一批来源出人意料却高度一致的账号。

X Account Location API 主要特性

  • X 为每个账号标注的国家country 就是主页“关于此账号”面板里“账号所在地”(Account based in)的值,例如 United States 或 United Kingdom。
  • 账号连接 X 的渠道connected_via 给出 X 记录的连接渠道,例如 United States App Store、Android App 或 Web,可以和 country 对照着看。
  • 注册时间与改名记录published_at 是账号加入 X 的日期,username_changes_count 是改过用户名的次数,两项合起来能快速看出一个账号有多“老”、多稳定。
  • 所属机构与身份认证affiliate_username 是主页上显示的机构徽章,例如 elonmusk 对应 X、BBCWorld 对应 BBCNews,同时附带 is_identity_verified 和蓝标字段 is_verified。
  • 一个任务查多个用户名,每个一行提交一组用户名,开头的 @ 可带可不带,每个账号单独返回一行,除所在地信息外还有 id、username、name、avatar_url 和 is_private。

X Account Location API 参数

参数必填描述
usernames必填要查询的 X 用户名,开头的 @ 可带可不带。每个账号单独返回一行。

如何使用 X Account Location API

提交用户名,每个账号读取一行“关于此账号”信息。

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

# X 上没有显示国家的账号同样会返回一行,country 为 null。

X Account Location API 最佳使用场景

  • 核查政治、新闻类账号的实际运营地: 把推动某个政治或新闻话题的账号批量查一遍,标出 country 或 connected_via 与其面向的受众分处世界不同地方的账号。
  • 付费合作前核查达人: 确认 country 与你想覆盖的市场一致,再看 published_at 和 username_changes_count,留意新注册或频繁改名的账号。
  • 归类疑似协同运营的账号: 按 country、connected_via 和注册月份给一批可疑账号分组,找出同一时间、同一地点集中注册的账号群。
  • 统计一场讨论背后的国家分布: 用其他 X 接口拿到回复或转发某条帖子的用户名,再批量查询并按 country 汇总,看讨论主要来自哪些地区。

X Account Location API 使用建议

  • 判定一个账号由境外运营之前,把 country、connected_via 和 published_at 放在一起看,单看一项容易误判。
  • 用 id 作为账号主键保存,username_changes_count 已经说明用户名随时可能改变。
  • 每行结果连同 collected_at 一起保存,过段时间用同一批用户名重新查询,就能发现 country、connected_via 或 username_changes_count 的变化。
  • 按 username 把返回结果和提交列表对上:部分账号不存在时,其余账号照常返回,缺失的账号只是没有对应的行。

除了 X Account Location API,需要其他类型的 X 公开数据时,可以使用以下 API。

  • Twitter Profile Scraper API — 按 username 获取公开账号身份、简介、头像、封面、账号状态和可见受众统计。
  • Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标,并排除回复。
  • X Followers List API — 按一个或多个 X 用户名采集公开关注者账号身份与可见资料指标。
  • X Following List API — 采集 X 公开账号关注的个人资料,包括身份、简介、账号状态、可见计数和来源 username。
  • X Post Retweeters API — 采集转发已知 X 或 Twitter status URL 的公开账号,并在整个任务中按账号去重后返回标准化主页记录。
  • X Verified Followers API — 采集关注某个主页的认证账号,附带用户名、显示名称、头像和注册时间。

探索其他平台

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

X Account Location API — 常见问题

X Account Location API 是一个用于按用户名列表读取 X 账号“关于此账号”信息的 API。它返回每个账号所在的国家或地区、连接 X 的方式、注册时间、改名次数、机构徽章和认证标记。

X 把它显示在主页“关于此账号”面板的“账号所在地”一栏。在这里提交用户名,同一个值会出现在 country 字段,一个任务就能查很多账号。

它表示账号从哪里连接 X,例如某个国家的 App Store、Android 应用或网页端。接口在 connected_via 字段返回这一项。

X 本身就不为部分账号显示国家,包括很多政府和公共机构账号,例如 NASA。这些账号仍会返回一行,其余字段照常填写,只有 country 为 null。

这是 X 在“关于此账号”面板中显示的值,原样返回。它代表 X 认定的账号所在地,是 X 给出的标签,并不是账号背后那个人此刻所在的位置。

不是。用户在主页上自己填写的位置是另一个字段,可以用 Twitter Profile Scraper API 获取,对应 location 字段。