Skip to main content
GET
获取 Instagram 音频元数据
通过 audioId 检索单个音频曲目的详细信息。可用于确认已保存的 id 是否仍然有效,或在发布前展示曲目的标题和封面图。

Header Parameters

Path Parameters

string
必填
曲目 id,由音频搜索返回。Instagram 无法识别的 id 会返回 code: 517。

响应字段

曲目的字段以扁平结构直接返回在响应对象上,而不是嵌套。Instagram 不会为每首曲目返回所有字段,因此请将除 audioId 以外的所有字段都视为可选。
string
找到曲目时为 success。
string
曲目 id,原样返回。
string
曲目标题。
string
Instagram 所显示的艺人名称。
integer
曲目时长(毫秒)。
string
封面图缩略图 URL。
string
music 或 original_sound。
boolean
该曲目是否可用于广告。
可用性因地区而异。 对于不存在的 id、在该账号所在地区未获授权的 id,以及未获得此用途授权的 id,Meta 返回的是同一个错误。这三种情况都会报告 517,因此在一个账号上可以解析的曲目, 在另一个账号上完全可能正常地失败。请先查询 id,而不要假设已保存的 id 仍然有效。

错误代码

代码 514 到 518 的说明见 Instagram Reels 音频错误;其余代码见 Ayrshare 错误参考。

后续步骤

搜索曲目

将曲目附加到 Reel