Passer au contenu principal
GET
Rechercher de l'audio Instagram
Recherchez par mot-clé dans le catalogue audio d’Instagram. Utilisez l’audioId renvoyé avec instagramOptions.audioConfiguration pour joindre la piste lors de la publication d’un 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.

Paramètres d’en-tête

Paramètres de requête

string
requis
Mot-clé à rechercher, comme un nom d’artiste ou de piste. Une valeur vide ou composée uniquement d’espaces renvoie code: 101.
string
défaut:"music"
Le catalogue dans lequel effectuer la recherche. Soit music pour les pistes commerciales sous licence, soit original_sound pour l’audio provenant des Reels d’autres créateurs. Toute autre valeur renvoie code: 101.
integer
Nombre maximum de pistes à renvoyer, de 1 à 100. Les valeurs non entières ou hors plage renvoient code: 101. Si omis, la valeur par défaut d’Instagram s’applique.

Champs de réponse

Instagram ne renvoie pas tous les champs pour chaque piste ; considérez donc tous les champs de piste, à l’exception d’audioId, comme facultatifs.
string
success lorsque la recherche a abouti. Une recherche sans correspondance dans le catalogue reste un succès.
string
Le mot-clé recherché, renvoyé en écho.
array
Les pistes correspondantes. Un tableau vide signifie que la recherche a été exécutée sans correspondance.

Erreurs

Les codes 514 à 518 sont décrits dans Erreurs audio des Reels Instagram ; les autres figurent dans la référence des erreurs Ayrshare.

Étapes suivantes

Joindre la piste à un Reel

Consulter une seule piste