Buscar audio de 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
Buscar audio de Instagram
Busca en el catálogo de audio con licencia de Instagram una pista para adjuntar a un Reel
GET
/
media
/
instagram
/
audio
/
search
Buscar audio de 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"
}
Busca en el catálogo de audio de Instagram por palabra clave. Usa el
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 devuelto con instagramOptions.audioConfiguration para adjuntar la pista cuando publiques un Reel.
Parámetros del header
Parámetros de query
string
requerido
Palabra clave a buscar, como el nombre de un artista o de una pista. Un valor vacío o compuesto solo
de espacios devuelve
code: 101.string
predeterminado:"music"
Qué catálogo buscar. Puede ser
music para pistas comerciales con licencia u original_sound para
audio tomado de los Reels de otros creadores. Cualquier otro valor devuelve code: 101.integer
Número máximo de pistas a devolver, de
1 a 100. Los valores no enteros o fuera de rango devuelven
code: 101. Si se omite, se aplica el valor predeterminado de Instagram.Campos de respuesta
Instagram no devuelve todos los campos para todas las pistas, así que trata todos los campos de pista exceptoaudioId como opcionales.
string
success cuando la búsqueda se completó. Una búsqueda sin coincidencias en el catálogo sigue siendo un éxito.string
La palabra clave buscada, devuelta como eco.
array
Pistas coincidentes. Un array vacío significa que la búsqueda se ejecutó y no encontró coincidencias.
Mostrar Campos de la pista
Mostrar Campos de la pista
string
El id que se pasa como
audioConfiguration.audioId al publicar un Reel.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. La música con licencia con frecuencia no está disponible
para anuncios aunque esté disponible para un Reel orgánico.
{
"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"
}
Errores
| Código | Significado |
|---|---|
| 101 | query ausente o vacío, un audioType no reconocido o un limit fuera del rango de 1 a 100. |
| 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, incluida una pista no disponible. En la búsqueda esto reporta 239 en lugar del 517 que devuelve el endpoint de consulta. |
| 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. |