Skip to main content
GET
取得 Instagram 音訊中繼資料
audioId 擷取單一音訊曲目的詳細資料。可用來確認先前儲存的 id 是否仍然有效,或在發布前顯示曲目的標題與封面圖。

標頭參數

路徑參數

string
必填
曲目 id,由音訊搜尋回傳。Instagram 無法識別的 id 會回傳 code: 517

回應欄位

曲目的欄位會以扁平方式直接回傳在回應物件上,而非巢狀結構。Instagram 不會為每首曲目回傳所有欄位,因此除 audioId 以外的所有欄位都應視為選填。
string
找到曲目時為 success
string
曲目 id,原樣回傳。
string
曲目標題。
string
Instagram 所顯示的藝人名稱。
integer
曲目長度(毫秒)。
string
封面圖縮圖 URL。
string
musicoriginal_sound
boolean
該曲目是否可用於廣告。
可用性因地區而異。 對於不存在的 id、在帳號所在地區未獲授權的 id, 以及未獲此用途授權的 id,Meta 都會回傳相同的錯誤。三種情況都回報 517,因此同一首曲目可能對某個帳號有效,對另一個帳號卻正當地失敗。 請以查詢確認 id,而不要假設先前儲存的 id 仍然可用。

錯誤

錯誤碼 514 到 518 的說明請參閱 Instagram Reels 音訊錯誤;其餘錯誤碼請參閱 Ayrshare 錯誤參考

後續步驟

搜尋曲目

將曲目附加到 Reel