跳轉到主要內容
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.

標頭參數

路徑參數

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