Skip to main content
GET
Instagram オーディオメタデータを取得
audioId を指定して、1 つのオーディオ楽曲の詳細を取得します。保存済みの ID がまだ有効かを確認したり、公開前に楽曲のタイトルとアートワークを表示したりするために使用します。

ヘッダーパラメータ

パスパラメータ

string
必須
オーディオ検索 が返す楽曲 ID。Instagram が認識しない ID は code: 517 を返します。

レスポンスフィールド

楽曲のフィールドは、ネストされるのではなく、レスポンスオブジェクトの直下にフラットに返されます。Instagram はすべての楽曲についてすべてのフィールドを返すとは限らないため、audioId 以外のすべてのフィールドはオプションとして扱ってください。
string
楽曲が見つかった場合は success
string
楽曲 ID がそのまま返されます。
string
楽曲のタイトル。
string
Instagram が表示するアーティスト名。
integer
楽曲の長さ(ミリ秒)。
string
カバーアートワークのサムネイル URL。
string
music または original_sound のいずれか。
boolean
その楽曲を広告で使用できるかどうか。
利用可否は地域に依存します。 Meta は、存在しない ID、アカウントの地域でライセンスされていない ID、 この用途でライセンスされていない ID に対して同じエラーを返します。3 つのケースはいずれも 517 として 報告されるため、あるアカウントでは解決できる楽曲が、別のアカウントでは正当に失敗することがあります。 保存済みの ID がまだ有効であると想定せず、照会して確認してください。

エラー

コード 514 から 518 については Instagram Reels オーディオエラー で説明されています。その他については Ayrshare エラーリファレンス を参照してください。

次のステップ

楽曲を検索する

楽曲を Reel に添付する