Pesquisar áudio do 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
Pesquisar áudio do Instagram
Pesquise no catálogo de áudio licenciado do Instagram uma faixa para anexar a um Reel
GET
/
media
/
instagram
/
audio
/
search
Pesquisar áudio do 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"
}
Pesquise no catálogo de áudio do Instagram por palavra-chave. Use o
Os códigos 514 a 518 estão descritos em Erros de áudio de Reels do Instagram; os demais estão na referência de erros do Ayrshare.
audioId retornado com instagramOptions.audioConfiguration para anexar a faixa ao publicar um Reel.
Parâmetros do header
Parâmetros de query
string
obrigatório
Palavra-chave a pesquisar, como o nome de um artista ou de uma faixa. Um valor vazio ou composto
apenas por espaços retorna
code: 101.string
padrão:"music"
Qual catálogo pesquisar. Use
music para faixas comerciais licenciadas ou original_sound para
áudio extraído de Reels de outros criadores. Qualquer outro valor retorna code: 101.integer
Número máximo de faixas a retornar, de
1 a 100. Valores não inteiros ou fora do intervalo
retornam code: 101. Quando omitido, aplica-se o padrão do próprio Instagram.Campos de resposta
O Instagram não retorna todos os campos para todas as faixas, portanto trate todos os campos da faixa, excetoaudioId, como opcionais.
string
success quando a pesquisa foi concluída. Uma pesquisa sem correspondências no catálogo ainda é um sucesso.string
A palavra-chave pesquisada, ecoada de volta.
array
Faixas correspondentes. Um array vazio significa que a pesquisa foi executada e não encontrou nada.
Mostrar Campos da faixa
Mostrar Campos da faixa
string
O id a passar como
audioConfiguration.audioId ao publicar um Reel.string
Título da faixa.
string
Nome do artista conforme o Instagram o exibe.
integer
Duração da faixa em milissegundos.
string
URL do thumbnail da arte de capa.
string
music ou original_sound.boolean
Se a faixa pode ser usada em um anúncio. Músicas licenciadas frequentemente não estão disponíveis
para anúncios mesmo quando estão disponíveis para um 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"
}
Erros
| Code | Significado |
|---|---|
| 101 | query ausente ou vazio, um audioType não reconhecido ou um limit fora do intervalo de 1 a 100. |
| 156 | O Instagram não está vinculado a este perfil. |
| 161 | A autorização do Instagram expirou ou foi revogada. Revincule a conta. |
| 239 | O Instagram rejeitou a requisição por um motivo em nível de conta, incluindo uma faixa indisponível. Na pesquisa, isso é reportado como 239, e não como o 517 retornado pelo endpoint de consulta. |
| 258 | O Instagram retornou uma resposta malformada ou uma falha não mapeada. |
| 425 | A conexão está sem uma permissão obrigatória do Instagram. Revincule e conceda todas as permissões. |
| 435 | O limite de taxa do Instagram foi atingido. Aguarde antes de tentar novamente. |
| 514 | O Instagram está vinculado com Instagram Login. A Audio API exige Facebook Login. |