Metadatos de un audio de 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
Metadatos de un audio de Instagram
Consulta los detalles de una sola pista de audio de Instagram por su id
GET
/
media
/
instagram
/
audio
/
{audioId}
Metadatos de un audio de 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"
}
Recupera los detalles de una pista de audio por su
Los códigos 514 a 518 se describen en Errores de audio de Instagram Reels; el resto están en la referencia de errores de Ayrshare.
audioId. Úsalo para confirmar que un id almacenado sigue siendo válido, o para mostrar el título y la carátula de una pista antes de publicar.
Parámetros del header
Parámetros de ruta
string
requerido
El id de la pista, tal como lo devuelve la búsqueda de audio. Un id
que Instagram no reconoce devuelve
code: 517.Campos de respuesta
Los campos de la pista se devuelven de forma plana en el objeto de respuesta, no anidados. Instagram no devuelve todos los campos para todas las pistas, así que trata todos los campos exceptoaudioId como opcionales.
string
success cuando la pista fue encontrada.string
El id de la pista, devuelto como eco.
string
Título de la pista.
string
Nombre del artista tal como lo muestra Instagram.
integer
Duración de la pista en milisegundos.
string
URL de la miniatura de la carátula.
string
Puede ser
music u original_sound.boolean
Si la pista puede usarse en un anuncio.
{
"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 disponibilidad depende de la región. Meta devuelve el mismo error para un id que no existe,
uno sin licencia en la región de la cuenta y uno sin licencia para este uso. Los tres reportan
517,
por lo que una pista que se resuelve para una cuenta puede fallar legítimamente para otra.
Consulta un id en lugar de asumir que uno almacenado sigue funcionando.Errores
| Código | Significado |
|---|---|
| 156 | Instagram no está vinculado a este perfil. |
| 161 | La autorización de Instagram expiró o fue revocada. Vuelve a vincular la cuenta. |
| 239 | Instagram rechazó la solicitud por un motivo a nivel de cuenta. |
| 258 | Instagram devolvió una respuesta malformada o un fallo no mapeado. |
| 425 | A la conexión le falta un permiso requerido de Instagram. Vuelve a vincular y concede todos los permisos. |
| 435 | Se alcanzó el límite de tasa de Instagram. Espera antes de reintentar. |
| 514 | Instagram está vinculado con Instagram Login. La Audio API requiere Facebook Login. |
| 516 | El audioId falta o está vacío. |
| 517 | Instagram no reconoce el id, o la pista no está disponible para esta cuenta. |