Instagram Followers Count
Instagram Followers Count 是账号在某一时点的公开资料快照，包含可见粉丝数、关注数、帖子数以及身份和认证信号。这些字段可用于比较受众规模、评估创作者、补全目录，并通过定期采集监测账号增长。
主要特性
- 可见主页计数从可公开访问的 Instagram 主页读取粉丝数、关注数和帖子数。
- username 与 URL 输入接受一个或多个公开 username、主页 URL，或使用任一输入类型提交批量数据。
- 仅返回计数结果响应只聚焦计数指标，不导出完整粉丝列表或关注列表。
- 主页身份字段在每条计数记录中返回公开展示名、主页 URL、头像、认证状态和隐私状态。
- 公开数据边界响应边界限定在公开结果内，不覆盖私密、已删除、受限或登录后才可见的主页数据。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
usernames | 可选 | 不带 @ 的公开 Instagram 用户名，多个值使用逗号或换行分隔；usernames 与 urls 至少提供一项。 |
urls | 可选 | 可选的公开 Instagram 个人主页 URL；urls 与 usernames 至少提供一项。 |
results_limit | 可选 | 采集任务请求的最大记录数，必须为正整数。 |
如何使用
把 username 或公开主页 URL 作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化主页指标。
- 准备一个或多个不带 @ 的 Instagram username，或公开主页 URL。
- 向 /v1/instagram/followers-count POST usernames 或 urls，以及可选的 results_limit。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
- 通过 /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
需要其他类型的 Instagram 公开数据时，可以使用以下 API。
- Instagram Posts API — 按 username 采集公开帖子、媒体、标签、提及、时间和互动指标。
- Instagram Reels API — 按 username 采集公开 Reels、媒体、音频、标签、提及和互动指标。
- Instagram Search API — 按关键词或账号名称搜索公开主页及可见账号信息。
- Instagram Comments API — 从帖子 URL 采集公开评论、作者、时间、点赞数和回复数。
- Instagram Profiles API — 按 username 获取公开主页身份、简介、链接、账号标记、分类和可见计数。
- Instagram Followers List API — 采集公开粉丝资料记录，并保留来源账号和关注关系上下文。
- Instagram Following List API — 采集 Instagram 账号公开可见的关注主页，返回身份、关注关系上下文和可见账号计数。
- Instagram Hashtag Posts API — 按 hashtag 发现公开帖子，返回来源标签、媒体、创作者、时间和可见互动指标。
- Instagram Tagged Posts API — 按 username 采集标记指定主页的公开帖子，返回作者、媒体、提及、被标记用户上下文和互动指标。
- Instagram Transcript API — 从公开 Post 或 Reel URL 提取字幕文本、语言、格式、来源 URL 和 shortcode。
- Instagram Audio Reels API — 按已知数字 audio ID 采集公开 Reels，返回说明文字、创作者、媒体、时间、可见互动和来源音频上下文。
- Instagram Highlight Items API — 通过已知 highlight ID 获取保存的公开 Story 内容，返回文本、作者身份、媒体、时间、可见指标和来源上下文。
- Instagram Post Info API — 通过已知公开帖子、Reel 或旧版 IGTV URL 查询说明文字、作者身份、媒体、时间、可见互动和输入上下文。
- Instagram Reels Search API — 按文本 query 搜索公开 Reels，返回说明文字、创作者、媒体、时间、可见互动指标和查询上下文。
- Instagram Story Highlights API — 按 username 列出公开快拍精选容器，返回标题、所属账号、媒体数量和可复用的 highlight ID。
- Instagram Trending Reels API — 采集趋势信息流当前展示的公开 Reel，返回说明文字、创作者、媒体、时间和可见互动指标。