跳转到主要内容
GET
获取 Instagram 音频元数据
通过 audioId 检索单个音频曲目的详细信息。可用于确认已保存的 id 是否仍然有效,或在发布前展示曲目的标题和封面图。
Requires Instagram linked through Facebook Login. Instagram's Audio API is only available to accounts connected via Facebook Login, which needs a Facebook Page connected to the Instagram account. Accounts connected with Instagram Login (the Ayrshare default) cannot search, look up, or attach audio, and every audio request returns code: 514.

This is a Meta restriction, not an Ayrshare one. Meta's documentation states the Audio API "is only available on the Instagram API with Facebook Login. It is not supported on the Instagram API with Instagram Login." No permission or plan upgrade changes it.

Three things are required:
1. An Instagram Business or Creator account
2. A Facebook Page connected to that Instagram account
3. Instagram linked to Ayrshare with Instagram Login disabled, so the Facebook Login flow is used

See the step-by-step setup guide.

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