Instagram Posts API

Instagram Posts

主要特性

• 按 username 采集帖子通过统一响应结构采集一个或多个公开 Instagram username 的帖子。
• 媒体引用与尺寸通过标准化媒体字段返回公开媒体、缩略图引用、尺寸和视频时长。
• 图片与视频记录把公开图片和视频帖子统一为一致的响应结构。
• 内容与互动字段在每条帖子记录中返回 caption、作者资料、发布时间、可见 metrics、hashtag 和 mention。
• 公开数据边界响应边界限定在公开结果内，不覆盖私密、已删除、受限或登录后才可见的内容。

参数

如何使用

把公开 username 作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化帖子结果。

1. 准备一个或多个不带 @ 的公开 Instagram username。
2. 向 /v1/instagram/posts POST usernames 和可选的 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/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

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

最佳使用场景

• 主页帖子采集： 把选定 Instagram username 的公开帖子采集成包含媒体引用和稳定标识的标准化记录。
• 内容研究： 为研究或分析团队收集公开帖子的 caption、发布时间、hashtag 和可见互动计数。
• 归档流程： 保存公开帖子元数据、媒体引用、作者资料、来源 URL 和采集时间，供审核队列、报表系统或内部记录使用。
• Campaign QA： 在合并活动数据前，检查达人或品牌发布的公开内容是否暴露了预期媒体、caption 和可见互动字段。
• 主页内容补全： 通过帖子 ID、作者信息、文案、媒体引用和可见指标，为现有主页或活动记录补充内容数据。

使用建议

• 提交不带 @ 的 username，并在验证新工作流时保持较小批次。
• 有些公开记录可能不会暴露媒体引用、计数器或发布时间，客户端需要能处理字段缺失。
• 遇到 429、challenge 或临时 blocking 时，使用保守重试和 backoff，不要对同一条内容高频硬重试。
• 需要按 profile 收集 Reels 时用 Reels API；需要发现内容线索时用 Search API；需要公开评论线程时再接 Comments API。
• 不要围绕私密账号、stories、highlights 或登录后字段设计工作流。

相关 API