Pular para o conteúdo principal
GET
Pesquisar áudio do Instagram
Pesquise no catálogo de áudio do Instagram por palavra-chave. Use o audioId retornado com instagramOptions.audioConfiguration para anexar a faixa ao publicar um Reel.
Requires Instagram linked through Facebook Login. Instagram's Audio API is only available to accounts connected via Facebook Login, which needs a Facebook Page connected to the Instagram account. Accounts connected with Instagram Login (the Ayrshare default) cannot search, look up, or attach audio, and every audio request returns code: 514.

This is a Meta restriction, not an Ayrshare one. Meta's documentation states the Audio API "is only available on the Instagram API with Facebook Login. It is not supported on the Instagram API with Instagram Login." No permission or plan upgrade changes it.

Three things are required:
1. An Instagram Business or Creator account
2. A Facebook Page connected to that Instagram account
3. Instagram linked to Ayrshare with Instagram Login disabled, so the Facebook Login flow is used

See the step-by-step setup guide.

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, exceto audioId, 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.

Erros

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.

Próximos passos

Anexar a faixa a um Reel

Consultar uma única faixa