Instagram Reels API

Instagram Reels

主要特性

• 按主页采集 Reels通过统一响应结构采集一个或多个 Instagram username 的公开 Reels。
• 内容、媒体与互动字段返回文案、发布时间、播放量、点赞数、评论数、分享数、时长、缩略图、视频引用、标签、提及和音频信息。
• 请求结果上限使用 results_limit 限制每次请求的 Reels 数量。
• 公开数据边界结果不包含私密、受限、已删除或登录后才可见的 Reels。

参数

如何使用

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

1. 准备一个或多个不带 @ 的公开 Instagram username。
2. 向 /v1/instagram/reels 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/reels" \
  -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。

最佳使用场景

• Reels 表现研究： 收集公开播放量、点赞数、评论数、分享数、caption 和发布时间，用来比较短视频表现。
• 达人发现： 先查看相关主页的公开 Reels，再对筛选出的达人调用 profile 或 posts timeline 类 API 做补全。
• 活动监控： 跟踪和发布活动、hashtag、音乐趋势、达人 brief 或固定内容形式相关的公开 Reels。
• 媒体归档流程： 保存公开 Reel 元数据、缩略图、来源 URL、时长、音频信息和采集时间，供审核或报表系统使用。
• 音频分析： 当公开音频字段可用时，可用于主题聚类、审核队列或创意分析。

使用建议

• 保存稳定 Reel ID、shortcode、URL 和 task ID，方便采集任务重试和审计。
• 批量收集公开主页 Reels 时，使用保守的 results_limit 和 backoff 逻辑。
• 有些公开 Reels 可能不会暴露计数器、视频引用或音频信息，客户端需要能处理字段缺失。
• 需要发现主页时用 Search API；需要选定 username 的公开 Reels 时用 Reels API。
• 不要围绕私密账号、受限 Reels 或登录后字段设计工作流。

相关 API