Instagram-Audio suchen
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ayrshare.com/api/media/instagram/audio/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/media/instagram/audio/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ayrshare.com/api/media/instagram/audio/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ayrshare.com/api/media/instagram/audio/search")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"query": "summer",
"audio": [
{
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
]
}
{
"status": "success",
"query": "asdfghjkl",
"audio": []
}
{
"status": "error",
"code": 514,
"action": "post",
"message": "Adding music to a Reel requires an Instagram account connected via Facebook Login. This profile is connected with Instagram Login, which Meta does not permit for music attach, search, or lookup. Please relink Instagram using Facebook Login and grant the instagram_content_publish permission, then try again.",
"platform": "instagram"
}
Media
Instagram-Audio suchen
Instagrams lizenzierten Audiokatalog nach einem Track durchsuchen, der an einen Reel angehängt werden soll
GET
/
media
/
instagram
/
audio
/
search
Instagram-Audio suchen
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ayrshare.com/api/media/instagram/audio/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/media/instagram/audio/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ayrshare.com/api/media/instagram/audio/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ayrshare.com/api/media/instagram/audio/search")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"query": "summer",
"audio": [
{
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
]
}
{
"status": "success",
"query": "asdfghjkl",
"audio": []
}
{
"status": "error",
"code": 514,
"action": "post",
"message": "Adding music to a Reel requires an Instagram account connected via Facebook Login. This profile is connected with Instagram Login, which Meta does not permit for music attach, search, or lookup. Please relink Instagram using Facebook Login and grant the instagram_content_publish permission, then try again.",
"platform": "instagram"
}
Durchsuchen Sie Instagrams Audiokatalog per Suchbegriff. Verwenden Sie die zurückgegebene
Die Codes 514 bis 518 sind unter Instagram-Reels-Audio-Fehler beschrieben; die übrigen finden Sie in der Ayrshare-Fehlerreferenz.
audioId mit instagramOptions.audioConfiguration, um den Track beim Veröffentlichen eines Reels anzuhängen.
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ßeraudioId 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.
Anzeigen Track-Felder
Anzeigen Track-Felder
string
Die ID, die beim Veröffentlichen eines Reels als
audioConfiguration.audioId übergeben wird.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. Lizenzierte Musik ist häufig nicht für Anzeigen verfügbar,
selbst wenn sie für einen organischen Reel verfügbar ist.
{
"status": "success",
"query": "summer",
"audio": [
{
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
]
}
{
"status": "success",
"query": "asdfghjkl",
"audio": []
}
{
"status": "error",
"code": 514,
"action": "post",
"message": "Adding music to a Reel requires an Instagram account connected via Facebook Login. This profile is connected with Instagram Login, which Meta does not permit for music attach, search, or lookup. Please relink Instagram using Facebook Login and grant the instagram_content_publish permission, then try again.",
"platform": "instagram"
}
Fehler
| Code | Bedeutung |
|---|---|
| 101 | Fehlende oder leere query, ein unbekannter audioType oder ein limit außerhalb von 1 bis 100. |
| 156 | Instagram ist nicht mit diesem Profil verknüpft. |
| 161 | Instagrams Autorisierung ist abgelaufen oder wurde widerrufen. Verknüpfen Sie das Konto erneut. |
| 239 | Instagram hat die Anfrage aus einem kontobezogenen Grund abgelehnt, einschließlich eines nicht verfügbaren Tracks. Bei der Suche wird 239 gemeldet statt der 517, die der Lookup-Endpunkt zurückgibt. |
| 258 | Instagram hat eine fehlerhafte Antwort oder einen nicht zugeordneten Fehler zurückgegeben. |
| 425 | Der Verbindung fehlt eine erforderliche Instagram-Berechtigung. Verknüpfen Sie erneut und erteilen Sie alle Berechtigungen. |
| 435 | Instagrams Ratenlimit wurde erreicht. Warten Sie vor dem erneuten Versuch. |
| 514 | Instagram ist mit Instagram Login verknüpft. Die Audio API erfordert Facebook Login. |