Obtenir les métadonnées audio Instagram
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/{audioId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/{audioId}', 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/{audioId}"
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/{audioId}",
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/{audioId}"
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/{audioId}")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
{
"status": "error",
"code": 517,
"action": "post",
"message": "The selected audio track is unavailable. It may be an invalid audio id, restricted in your region, or not licensed for this use. Please choose a different track using the Instagram audio search endpoint and try again.",
"platform": "instagram"
}
Media
Obtenir les métadonnées audio Instagram
Consultez les détails d’une seule piste audio Instagram à partir de son identifiant
GET
/
media
/
instagram
/
audio
/
{audioId}
Obtenir les métadonnées audio Instagram
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/{audioId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/{audioId}', 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/{audioId}"
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/{audioId}",
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/{audioId}"
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/{audioId}")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
{
"status": "error",
"code": 517,
"action": "post",
"message": "The selected audio track is unavailable. It may be an invalid audio id, restricted in your region, or not licensed for this use. Please choose a different track using the Instagram audio search endpoint and try again.",
"platform": "instagram"
}
Récupérez les détails d’une piste audio à partir de son
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. Utilisez cet endpoint pour confirmer qu’un identifiant stocké est toujours valide, ou pour afficher le titre et la pochette d’une piste avant de publier.
Paramètres d’en-tête
Paramètres de chemin
string
requis
L’identifiant de la piste, tel que renvoyé par la recherche audio.
Un identifiant qu’Instagram ne reconnaît pas renvoie
code: 517.Champs de réponse
Les champs de la piste sont renvoyés à plat sur l’objet de réponse plutôt qu’imbriqués. Instagram ne renvoie pas tous les champs pour chaque piste ; considérez donc tous les champs, à l’exception d’audioId, comme facultatifs.
string
success lorsque la piste a été trouvée.string
L’identifiant de la piste, renvoyé en écho.
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é.
{
"status": "success",
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
{
"status": "error",
"code": 517,
"action": "post",
"message": "The selected audio track is unavailable. It may be an invalid audio id, restricted in your region, or not licensed for this use. Please choose a different track using the Instagram audio search endpoint and try again.",
"platform": "instagram"
}
La disponibilité dépend de la région. Meta renvoie la même erreur pour un identifiant qui
n’existe pas, pour un identifiant non licencié dans la région du compte, et pour un identifiant
non licencié pour cet usage. Les trois cas renvoient
517 ; une piste qui se résout pour un compte
peut donc légitimement échouer pour un autre. Consultez un identifiant plutôt que de supposer
qu’un identifiant stocké fonctionne toujours.Erreurs
| Code | Signification |
|---|---|
| 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. |
| 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. |
| 516 | L’audioId est manquant ou vide. |
| 517 | Instagram ne reconnaît pas l’identifiant, ou la piste est indisponible pour ce compte. |