Skip to main content
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.

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