X Following List API

X Following List

主要特性

• 多来源账号关注列表采集接收一个或多个公开 X username，并分别对每个来源账号执行有数量上限的关注列表采集。
• 个人资料身份与背景信息返回已关注账号的 ID、username、显示名称、规范主页 URL、简介、网站、地点、头像、封面和账号创建时间。
• 账号状态与公开计数将认证、保护、私信、置顶帖子和自动化状态，与关注者、正在关注、帖子、媒体和点赞计数放入同一记录。
• 带来源信息的标准化记录以一致的公开结构保存个人资料，并通过 collected_at 和 extra.input_username 保留采集时间与来源线索。

参数

如何使用

提交公开来源账号，再从完成的异步任务中读取标准化的已关注个人资料记录。

1. 准备一个或多个公开 X username，可以带或不带开头的 @，并为每个 username 选择 200 到 2000 之间且为 200 倍数的 results_limit。
2. 将 usernames 和 results_limit POST 到 /v1/x/following-list，并保留返回的 task_id。
3. 任务处于 queued、running 或 retrying 时轮询 GET /v1/tasks/{task_id}，直到成功或失败。
4. 任务成功后读取 data.results.items；当 data.results.has_more 为 true 时，继续把 next_cursor 传给同一任务接口。

curl -X POST "https://api.socq.ai/v1/x/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@X"],"results_limit":200}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 data.results.has_more 为 true 时继续传入 next_cursor

最佳使用场景

• 兴趣网络研究： 结合保留的来源 username 与已关注对象的身份、简介、链接和地点，研究已知账号周边的公开兴趣网络。
• 从种子账号发现候选账号： 利用名称、简介、图片、认证状态和可见计数，查看从来源账号公开关注列表中发现的候选对象。
• 关注关系记录补全： 为基于 username 的现有关系记录补充稳定 ID、规范主页 URL、公开账号信息、计数和采集时间。

使用建议

• 提交前移除开头的 @，并按不区分大小写的方式去重来源 username，避免同一账号因不同写法重复执行来源采集。
• 按每个 username 的需要以 200 为步长设置 results_limit；提交多个来源时，应按 usernames 数量乘以 results_limit 估算列表结束和任务级去重前的结果上限。
• 构建多对多关系图时，不要假设每个来源账号与关注对象组合都会保存一行，因为重复个人资料可能被去重，并只保留其中一个 extra.input_username。
• 将空列表或较短列表视为公开可见性结果，并允许可选图片、账号状态和计数在下游记录中保持为空。
• 不要把返回顺序解释为关系建立时间、互动强度或认可，因为响应只提供采集顺序，不包含这些信号。

相关 API