Instagram Followers Count API

Instagram Followers Count

主要特性

• 可见主页计数从可公开访问的 Instagram 主页读取粉丝数、关注数和帖子数。
• username 与 URL 输入接受一个或多个公开 username、主页 URL，或使用任一输入类型提交批量数据。
• 仅返回计数结果响应只聚焦计数指标，不导出完整粉丝列表或关注列表。
• 主页身份字段在每条计数记录中返回公开展示名、主页 URL、头像、认证状态和隐私状态。
• 公开数据边界响应边界限定在公开结果内，不覆盖私密、已删除、受限或登录后才可见的主页数据。

参数

如何使用

把 username 或公开主页 URL 作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化主页指标。

1. 准备一个或多个不带 @ 的 Instagram username，或公开主页 URL。
2. 向 /v1/instagram/followers-count POST usernames 或 urls，以及可选的 results_limit。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 通过 /v1/tasks/{task_id}?limit=50 读取 data.results，有更多记录时继续传 results.next_cursor。

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

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

最佳使用场景

• 达人增长监控： 定期刷新关注中的达人账号粉丝数和关注数，对比每次运行之间的变化。
• 品牌和竞品跟踪： 监控品牌、竞品、活动账号和合作账号的公开主页计数变化。
• 受众分析： 先用计数指标做轻量筛选，再决定哪些公开主页需要进一步补全。
• CRM 和达人库补全： 给已有账号记录补充公开计数、主页 URL、展示名和认证状态。
• 报表快照： 为每条结果保存 collected_at，让仪表盘能展示每次计数刷新的时间和来源。

使用建议

• 这个 endpoint 适合刷新计数；如果还需要公开内容记录，请使用 Posts 或 Reels API。
• 每条记录都建议保存 collected_at，因为公开计数会随着时间变化。
• 批量请求使用保守规模；公开结果暂时不可用时，用 backoff 重试。
• posts_count、头像或 verified 等字段缺失是正常情况，客户端需要能处理。
• 不要围绕私密主页、完整粉丝列表或登录后可见的 Instagram 数据设计工作流。

相关 API