Zum Hauptinhalt springen
GET
Instagram-Audio suchen
Durchsuchen Sie Instagrams Audiokatalog per Suchbegriff. Verwenden Sie die zurückgegebene audioId mit instagramOptions.audioConfiguration, um den Track beim Veröffentlichen eines Reels anzuhängen.
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

Query-Parameter

string
erforderlich
Suchbegriff, z. B. ein Künstler- oder Track-Name. Ein leerer oder nur aus Leerzeichen bestehender Wert gibt code: 101 zurück.
string
Standard:"music"
Welcher Katalog durchsucht wird. Entweder music für lizenzierte kommerzielle Tracks oder original_sound für Audio aus den Reels anderer Creator. Jeder andere Wert gibt code: 101 zurück.
integer
Maximale Anzahl zurückzugebender Tracks, von 1 bis 100. Nicht ganzzahlige Werte oder Werte außerhalb des Bereichs geben code: 101 zurück. Wird der Parameter weggelassen, gilt Instagrams eigener Standardwert.

Antwortfelder

Instagram gibt nicht für jeden Track jedes Feld zurück; behandeln Sie daher alle Track-Felder außer audioId als optional.
string
success, wenn die Suche abgeschlossen wurde. Auch ein Katalog-Ergebnis ohne Treffer ist ein Erfolg.
string
Der gesuchte Suchbegriff, als Echo zurückgegeben.
array
Passende Tracks. Ein leeres Array bedeutet, dass die Suche ausgeführt wurde und nichts gefunden hat.

Fehler

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

Nächste Schritte

Den Track an einen Reel anhängen

Einen einzelnen Track nachschlagen