Instagram 公开数据 API
通过统一的异步 API 流程发现公开主页，并采集帖子、Reels、评论、粉丝计数、互动指标和媒体元数据。
可用的 Instagram API
根据需求选择主页发现、账号计数、公开帖子、Reels 或评论接口。所有接口使用相同的 SocQ 鉴权和任务结果流程。
可以获取哪些 Instagram 数据？
SocQ 将公开 Instagram 结果整理成稳定的 JSON 记录，产品团队无需分别维护浏览器自动化和响应清洗流程。
主页与发现
搜索公开账号，返回 username、显示名称、bio、主页 URL、头像、验证状态和可见账号信号。
粉丝与账号计数
按公开 username 或主页 URL 获取可见粉丝数、关注数和帖子数。
公开帖子
按 username 采集 caption、作者、时间、媒体引用、hashtag、mention 和可见点赞或评论。
公开 Reels
在字段可用时采集 Reel caption、媒体引用、播放与互动计数、时长、hashtag、mention 和音频信息。
公开评论
按公开 Instagram Post URL 采集评论文本、作者字段、时间、Post 引用和可见点赞或回复计数。
SocQ 与 Instagram Graph API 对比
两者解决不同的集成问题：SocQ 面向标准化公开数据采集；Meta 官方 API 主要面向已授权专业账号和平台操作。
| 能力 | SocQ | Instagram Graph API |
|---|---|---|
| 主要用途 | 采集公开主页、内容和评论数据 | 管理已授权的 Business 和 Creator 账号 |
| 用户 OAuth | 使用 SocQ API key，无需用户 Instagram OAuth | 需要 Meta 应用配置和账号授权 |
| 发布内容 | 不支持 | 符合条件的专业账号可用 |
| 私密内容 | 不支持 | 仅限授权权限允许的数据 |
| 响应格式 | 在 SocQ 接口间保持标准化 | Meta Graph 原生响应结构 |
Instagram API 如何工作
全部 Instagram 接口使用相同的异步流程，避免长时间采集占用业务请求线程。
1. 提交任务
通过 POST 传入搜索词、username、公开主页或内容 URL，并可指定 results_limit。
2. 轮询任务状态
使用返回的 task ID 等待 succeeded 或 failed，并使用 backoff 避免高频轮询。
3. 读取标准化结果
获取结果记录、保存稳定 ID，并在有更多数据时继续传 next_cursor。
使用 SocQ API key 鉴权。以下示例启动公开 Instagram 主页搜索；帖子、Reels、评论和粉丝数接口使用相同任务流程。
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"sustainable travel","results_limit":25}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 GET /v1/tasks/{task_id}?limit=50常见 Instagram API 使用场景
达人发现
发现相关公开主页，再用帖子、Reels 和可见粉丝指标补全选中的账号。
内容监控
跟踪活动、竞品、达人或固定内容形式相关的公开帖子、Reels 和选定公开评论记录。
分析数据补全
为内部仪表盘、数据仓库和报表系统补充公开社媒身份与互动字段。
研究目录
使用稳定 URL、ID 和采集时间构建可审核的公开账号与内容数据集。
限制与公开数据政策
SocQ 的范围限定在公开可用的 Instagram 结果，账号、内容和公开数据源发生变化时，字段可用性也可能变化。
- 不支持私密、受限、已删除或登录后才可见的内容。
- 部分公开记录可能缺少计数、评论字段、媒体引用、bio 或音频字段。
- 建议使用保守请求频率、cursor 分页，并在遇到限速时进行 backoff。
- 这些接口不用于发布、编辑或删除 Instagram 内容。
Instagram API 常见问题
这是 Instagram 官方 Graph API 吗？
不是。SocQ 提供对受支持公开 Instagram 结果的标准化访问。需要授权账号管理或发布内容时，应使用 Meta Graph API。
用户需要连接 Instagram 账号吗？
受支持的公开数据接口不需要用户进行 Instagram OAuth，调用请求使用 SocQ API key。
可以访问私密主页吗？
不可以。私密、受限和登录后才可见的 Instagram 内容不在支持范围内。
如何计费？
每个接口卡片都会显示当前每条结果的积分价格，任务按照返回的标准化结果记录计费。