Instagram Following List API

Instagram Following List

主要特性

• 批量来源账号在同一个任务中提交一个或多个公开 Instagram username，输入值不带 @ 前缀。
• 关系来源上下文在 extra 中保留 source_username、relationship 和 position，便于把每个主页追溯到来源账号。
• 标准化主页身份在字段可用时返回主页 ID、username、展示名称、规范主页 URL、头像以及公开认证或隐私标记。
• 可见账号指标当公开结果包含相关值时，返回粉丝数、关注数和帖子数，便于补全账号画像。
• 异步结果分页在请求线程之外执行采集任务，轮询任务状态，并使用 next_cursor 分页读取标准化结果。

参数

如何使用

把公开 username 作为异步任务提交，轮询返回的 task ID，再通过 cursor 分页读取标准化关注主页。

1. 准备一个或多个不带 @ 前缀的公开 Instagram username。
2. 向 /v1/instagram/following-list POST usernames，以及 1 到 2,000 之间的可选 results_limit。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 通过 /v1/tasks/{task_id}?limit=50 读取结果；has_more 为 true 时继续传入 results.next_cursor。

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

# 轮询 GET /v1/tasks/{task_id}
# 读取 GET /v1/tasks/{task_id}?limit=50，并继续使用 data.results.next_cursor

最佳使用场景

• 创作者关系图谱： 构建可审查的关系图，了解选定公开账号关注了哪些创作者、媒体和组织主页。
• 品牌账号研究： 比较品牌、活动、地区或竞品账号公开可见的关注关系。
• 合作对象发现： 从与合作计划相关的账号关注列表中识别公开主页，形成候选对象集合。
• 主页目录补全： 为内部目录补充规范 URL、展示名称、头像、账号标记和关系来源。
• 关系变化追踪： 保存带时间的快照，并跨批次比较稳定主页 ID，以审查新增或移除关系。

使用建议

• 提交前移除每个 username 的 @ 前缀，供应商入参会统一为纯 username。
• 先使用聚焦的 results_limit，只有在工作流确实需要更大公开关系集合时再逐步提高。
• 把主页 ID 与 extra.source_username 一起保存，因为同一主页可能出现在多个来源账号的关注结果中。
• 头像、账号计数、认证标记或 position 缺失属于公开结果的正常差异，客户端应允许这些字段为空。
• 工作流应处理空结果或部分结果，因为私密、受限、已删除或登录后可见的关系不在支持边界内。

相关 API