Skip to main content
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.

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