Instagram Audio Reels API

Instagram Audio Reels

主要特性

• 按已知 Audio ID 定向采集一次提交一个或多个 Instagram 数字 audio ID，采集与这些准确标识关联的公开 Reels，而不是按标题或艺人搜索音频。
• 每个音频独立采集每个 audio ID 分别使用 results_limit 和 cursor，并在该输入的采集过程中去除重复记录，使各来源都有明确的数据量边界。
• 保留来源的 Reel 记录以统一结构返回 Reel ID、URL、说明文字、创作者身份、媒体、时间、可见互动和 extra.audio_id 来源信息。

参数

如何使用

把已知 audio ID 作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化 Reel 记录。

1. 准备一个或多个已知 Instagram audio ID，每个值都应为非空数字字符串。
2. 向 /v1/instagram/audio-reels POST audio_ids，以及可选的单音频 results_limit。
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/audio-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_ids":["123456789012345"],"results_limit":20}'

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

最佳使用场景

• 查看音频参与情况： 按 extra.audio_id 汇总公开 Reel URL、说明文字、创作者和发布时间，查看已知音频下公开可见的参与内容。
• 研究创意样本： 利用说明文字、创作者身份、媒体引用和原始 Reel URL，为选定 audio ID 建立可回溯的样本集。
• 比较可见互动： 比较所采集 Reels 的可用点赞、评论、观看和播放计数，同时保留产生每条记录的 audio ID。

使用建议

• 提交前先取得并核实 audio ID；本接口只接受数字标识，不按歌曲标题、艺人名称或关键词查找音频。
• 按 audio ID 规划数据量和预估积分，因为 results_limit 分别作用于每个提交的标识。
• 合并多次采集结果时，使用稳定 Reel ID 或标准 URL 去重，并保留 extra.audio_id 追溯来源。
• 把互动计数、媒体、创作者字段和时间按可选值处理，并将结果理解为受单音频数量上限、feed 终点或 100 页上限约束的公开集合，而不是完整历史档案。

相关 API