メインコンテンツへスキップ
GET
Instagram オーディオを検索
キーワードで Instagram のオーディオカタログを検索します。返された audioId を instagramOptions.audioConfiguration で使用すると、Reel の公開時にその楽曲を添付できます。
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
必須
アーティスト名や楽曲名などの検索キーワード。空の値や空白のみの値は 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 に添付する

単一の楽曲を照会する