Zum Hauptinhalt springen
GET
Instagram-Audio-Metadaten abrufen
Rufen Sie die Details eines einzelnen Audiotracks anhand seiner audioId ab. Verwenden Sie dies, um zu bestätigen, dass eine gespeicherte ID noch gültig ist, oder um Titel und Artwork eines Tracks vor dem Veröffentlichen anzuzeigen.
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.

Header-Parameter

Pfadparameter

string
erforderlich
Die Track-ID, wie sie von der Audio-Suche zurückgegeben wird. Eine ID, die Instagram nicht erkennt, gibt code: 517 zurück.

Antwortfelder

Die Felder des Tracks werden flach auf dem Antwortobjekt zurückgegeben und nicht verschachtelt. Instagram gibt nicht für jeden Track jedes Feld zurück; behandeln Sie daher alle Felder außer audioId als optional.
string
success, wenn der Track gefunden wurde.
string
Die Track-ID, als Echo zurückgegeben.
string
Track-Titel.
string
Künstlername, wie Instagram ihn anzeigt.
integer
Track-Länge in Millisekunden.
string
Thumbnail-URL des Cover-Artworks.
string
Entweder music oder original_sound.
boolean
Ob der Track in einer Anzeige verwendet werden darf.
Die Verfügbarkeit ist regionsabhängig. Meta gibt denselben Fehler für eine ID zurück, die nicht existiert, eine, die in der Region des Kontos nicht lizenziert ist, und eine, die nicht für diese Nutzung lizenziert ist. Alle drei melden 517, sodass ein Track, der für ein Konto aufgelöst wird, für ein anderes berechtigterweise fehlschlagen kann. Schlagen Sie eine ID nach, statt anzunehmen, dass eine gespeicherte noch funktioniert.

Fehler

Die Codes 514 bis 518 sind unter Instagram-Reels-Audio-Fehler beschrieben; die übrigen finden Sie in der Ayrshare-Fehlerreferenz.

Nächste Schritte

Nach einem Track suchen

Den Track an einen Reel anhängen