Instagram Trending Reels API

Instagram Trending Reels

主要特性

• 无需筛选条件的信息流快照无需提交 query、账号、hashtag、地区或日期筛选条件，即可采集趋势信息流当前展示的 Reel 集合。
• 标准化 Reel 记录以统一结构返回 Reel 身份、公开 URL、说明文字、作者上下文、媒体元数据、时间，以及可见的点赞、评论、观看和播放次数。
• 重复记录抑制保存标准化结果前，按 Reel ID、主键或 shortcode 合并信息流中的重复记录。

参数

如何使用

以空 JSON 对象提交异步任务，轮询 task ID，完成后再用结果 cursor 读取保存的快照记录。

1. 准备一个空 JSON 对象。
2. 把请求体 POST 到 /v1/instagram/trending-reels。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 通过 /v1/tasks/{task_id}?limit=50 读取 results.items，在 results.has_more 为 true 时继续传 results.next_cursor。

curl -X POST "https://api.socq.ai/v1/instagram/trending-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续传 next_cursor

最佳使用场景

• 当前发现内容清单： 保存 Reel ID、公开 URL、说明文字、创作者身份和采集时间，形成可审核的当前信息流快照记录。
• 短视频创意审核： 检查单次快照中的说明文字、作者上下文、缩略图、视频引用、尺寸和时长，审核其中展示的创意内容。
• 快照内互动比较： 使用同一采集任务返回的可见点赞、评论、观看、播放次数和创建时间，对比不同 Reel。

使用建议

• 仅提交空对象；接口会拒绝 query、地区、username、hashtag、日期和 results_limit 字段。
• 将每次响应理解为采集时由来源定义的信息流快照，不要把结果解读为官方排名公式、全球覆盖或地区覆盖结论。
• 不要请求上游下一页；results.next_cursor 只用于继续读取已完成任务中保存的记录。
• 保留多次快照时，使用稳定 Reel ID 或 URL 跨任务去重，因为采集器只会在单次信息流响应内抑制重复记录。
• 自行构建时间序列时保留每条记录的 collected_at，因为本接口不提供历史快照或定时任务。
• 将说明文字、作者字段、计数、媒体、URL 和创建时间按可空的公开字段处理。

相关 API