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
提交用户名,每个账号读取一行“关于此账号”信息。
- 向 /v1/x/user-about 发送 {"usernames": ["elonmusk", "BBCWorld"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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 把返回结果和提交列表对上:部分账号不存在时,其余账号照常返回,缺失的账号只是没有对应的行。
相关 API
除了 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 — 采集关注某个主页的认证账号,附带用户名、显示名称、头像和注册时间。
- Twitter Tweet 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 Follow Checker API
- Twitter Video Transcript API