Instagram Audio Reels
Instagram Audio Reels 是关联同一音频标识的公开短视频，包含说明文字、创作者身份、媒体引用、发布时间和可见互动。这些带来源关联的记录可用于查看音频参与情况、研究创意样本，以及比较不同 audio ID 下的公开 Reel 活动。
主要特性
- 按已知 Audio ID 定向采集一次提交一个或多个 Instagram 数字 audio ID，采集与这些准确标识关联的公开 Reels，而不是按标题或艺人搜索音频。
- 每个音频独立采集每个 audio ID 分别使用 results_limit 和 cursor，并在该输入的采集过程中去除重复记录，使各来源都有明确的数据量边界。
- 保留来源的 Reel 记录以统一结构返回 Reel ID、URL、说明文字、创作者身份、媒体、时间、可见互动和 extra.audio_id 来源信息。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
audio_ids | 必填 | 一个或多个已知 Instagram audio ID，每个值均为非空数字字符串，多个值使用逗号或换行分隔。 |
results_limit | 可选 | 每个 audio ID 请求的最大记录数；默认为 100，接受 20 到 2,000 的整数。 |
如何使用
把已知 audio ID 作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化 Reel 记录。
- 准备一个或多个已知 Instagram audio ID，每个值都应为非空数字字符串。
- 向 /v1/instagram/audio-reels POST audio_ids，以及可选的单音频 results_limit。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
- 通过 /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
需要其他类型的 Instagram 公开数据时，可以使用以下 API。
- Instagram Followers Count API — 获取公开账号身份以及可见粉丝数、关注数和帖子数。
- Instagram Posts API — 按 username 采集公开帖子、媒体、标签、提及、时间和互动指标。
- Instagram Reels API — 按 username 采集公开 Reels、媒体、音频、标签、提及和互动指标。
- Instagram Search API — 按关键词或账号名称搜索公开主页及可见账号信息。
- Instagram Comments API — 从帖子 URL 采集公开评论、作者、时间、点赞数和回复数。
- Instagram Profiles API — 按 username 获取公开主页身份、简介、链接、账号标记、分类和可见计数。
- Instagram Followers List API — 采集公开粉丝资料记录，并保留来源账号和关注关系上下文。
- Instagram Following List API — 采集 Instagram 账号公开可见的关注主页，返回身份、关注关系上下文和可见账号计数。
- Instagram Hashtag Posts API — 按 hashtag 发现公开帖子，返回来源标签、媒体、创作者、时间和可见互动指标。
- Instagram Tagged Posts API — 按 username 采集标记指定主页的公开帖子，返回作者、媒体、提及、被标记用户上下文和互动指标。
- Instagram Transcript API — 从公开 Post 或 Reel URL 提取字幕文本、语言、格式、来源 URL 和 shortcode。
- Instagram Highlight Items API — 通过已知 highlight ID 获取保存的公开 Story 内容，返回文本、作者身份、媒体、时间、可见指标和来源上下文。
- Instagram Post Info API — 通过已知公开帖子、Reel 或旧版 IGTV URL 查询说明文字、作者身份、媒体、时间、可见互动和输入上下文。
- Instagram Reels Search API — 按文本 query 搜索公开 Reels，返回说明文字、创作者、媒体、时间、可见互动指标和查询上下文。
- Instagram Story Highlights API — 按 username 列出公开快拍精选容器，返回标题、所属账号、媒体数量和可复用的 highlight ID。
- Instagram Trending Reels API — 采集趋势信息流当前展示的公开 Reel，返回说明文字、创作者、媒体、时间和可见互动指标。