Passer au contenu principal
GET
Obtenir les métadonnées audio Instagram
Récupérez les détails d’une piste audio à partir de son audioId. Utilisez cet endpoint pour confirmer qu’un identifiant stocké est toujours valide, ou pour afficher le titre et la pochette d’une piste avant de publier.
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 chemin

string
requis
L’identifiant de la piste, tel que renvoyé par la recherche audio. Un identifiant qu’Instagram ne reconnaît pas renvoie code: 517.

Champs de réponse

Les champs de la piste sont renvoyés à plat sur l’objet de réponse plutôt qu’imbriqués. Instagram ne renvoie pas tous les champs pour chaque piste ; considérez donc tous les champs, à l’exception d’audioId, comme facultatifs.
string
success lorsque la piste a été trouvée.
string
L’identifiant de la piste, renvoyé en écho.
string
Titre de la piste.
string
Nom de l’artiste tel qu’Instagram l’affiche.
integer
Durée de la piste en millisecondes.
string
URL de la miniature de la pochette.
string
Soit music, soit original_sound.
boolean
Indique si la piste peut être utilisée dans une publicité.
La disponibilité dépend de la région. Meta renvoie la même erreur pour un identifiant qui n’existe pas, pour un identifiant non licencié dans la région du compte, et pour un identifiant non licencié pour cet usage. Les trois cas renvoient 517 ; une piste qui se résout pour un compte peut donc légitimement échouer pour un autre. Consultez un identifiant plutôt que de supposer qu’un identifiant stocké fonctionne toujours.

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

Rechercher une piste

Joindre la piste à un Reel