Rechercher de l'audio Instagram
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
Rechercher de l'audio Instagram
Recherchez dans le catalogue audio sous licence d’Instagram une piste à joindre à un Reel
GET
/
media
/
instagram
/
audio
/
search
Rechercher de l'audio Instagram
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"
}
Recherchez par mot-clé dans le catalogue audio d’Instagram. Utilisez l’
Les codes 514 à 518 sont décrits dans Erreurs audio des Reels Instagram ; les autres figurent dans la référence des erreurs Ayrshare.
audioId renvoyé avec instagramOptions.audioConfiguration pour joindre la piste lors de la publication d’un Reel.
Paramètres d’en-tête
Paramètres de requête
string
requis
Mot-clé à rechercher, comme un nom d’artiste ou de piste. Une valeur vide ou composée uniquement
d’espaces renvoie
code: 101.string
défaut:"music"
Le catalogue dans lequel effectuer la recherche. Soit
music pour les pistes commerciales sous
licence, soit original_sound pour l’audio provenant des Reels d’autres créateurs. Toute autre
valeur renvoie code: 101.integer
Nombre maximum de pistes à renvoyer, de
1 à 100. Les valeurs non entières ou hors plage
renvoient code: 101. Si omis, la valeur par défaut d’Instagram s’applique.Champs de réponse
Instagram ne renvoie pas tous les champs pour chaque piste ; considérez donc tous les champs de piste, à l’exception d’audioId, comme facultatifs.
string
success lorsque la recherche a abouti. Une recherche sans correspondance dans le catalogue reste un succès.string
Le mot-clé recherché, renvoyé en écho.
array
Les pistes correspondantes. Un tableau vide signifie que la recherche a été exécutée sans correspondance.
Afficher Champs de piste
Afficher Champs de piste
string
L’identifiant à passer comme
audioConfiguration.audioId lors de la publication d’un Reel.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 musique sous licence est souvent
indisponible pour les publicités même lorsqu’elle est disponible pour un Reel organique.
{
"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"
}
Erreurs
| Code | Signification |
|---|---|
| 101 | query manquant ou vide, audioType non reconnu, ou limit en dehors de 1 à 100. |
| 156 | Instagram n’est pas connecté à ce profil. |
| 161 | L’autorisation Instagram a expiré ou a été révoquée. Reconnectez le compte. |
| 239 | Instagram a rejeté la requête pour une raison liée au compte, y compris une piste indisponible. Sur la recherche, cela renvoie 239 plutôt que le 517 renvoyé par l’endpoint de consultation. |
| 258 | Instagram a renvoyé une réponse malformée ou un échec non mappé. |
| 425 | La connexion ne dispose pas d’une autorisation Instagram requise. Reconnectez le compte et accordez toutes les autorisations. |
| 435 | La limite de débit d’Instagram a été atteinte. Attendez avant de réessayer. |
| 514 | Instagram est connecté avec Instagram Login. L’API Audio nécessite Facebook Login. |