Skip to main content
GET
Instagram オーディオを検索
キーワードで Instagram のオーディオカタログを検索します。返された audioIdinstagramOptions.audioConfiguration で使用すると、Reel の公開時にその楽曲を添付できます。

ヘッダーパラメータ

クエリパラメータ

string
必須
アーティスト名や楽曲名などの検索キーワード。空の値や空白のみの値は code: 101 を返します。
string
デフォルト:"music"
検索対象のカタログ。ライセンスされた商用楽曲は music、他のクリエイターの Reels から取得されたオーディオは original_sound を指定します。それ以外の値は code: 101 を返します。
integer
返される楽曲の最大数で、1 から 100 までです。整数でない値や範囲外の値は code: 101 を返します。 省略した場合は、Instagram 自身のデフォルトが適用されます。

レスポンスフィールド

Instagram はすべての楽曲についてすべてのフィールドを返すとは限らないため、audioId 以外のすべての楽曲フィールドはオプションとして扱ってください。
string
検索が完了した場合は success。カタログに一致がない場合も成功として扱われます。
string
検索されたキーワードがそのまま返されます。
array
一致した楽曲。空の配列は、検索は実行されたものの何も一致しなかったことを意味します。

エラー

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

次のステップ

楽曲を Reel に添付する

単一の楽曲を照会する