Skip to main content
GET
Obter metadados de áudio do Instagram
Recupere os detalhes de uma faixa de áudio pelo seu audioId. Use este endpoint para confirmar que um id armazenado ainda é válido ou para exibir o título e a arte de capa de uma faixa antes de publicar.

Parâmetros do header

Parâmetros de caminho

string
obrigatório
O id da faixa, conforme retornado pela pesquisa de áudio. Um id que o Instagram não reconhece retorna code: 517.

Campos de resposta

Os campos da faixa são retornados diretamente no objeto de resposta, sem aninhamento. O Instagram não retorna todos os campos para todas as faixas, portanto trate todos os campos, exceto audioId, como opcionais.
string
success quando a faixa foi encontrada.
string
O id da faixa, ecoado de volta.
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.
A disponibilidade depende da região. A Meta retorna o mesmo erro para um id que não existe, para um que não está licenciado na região da conta e para um que não está licenciado para este uso. Os três reportam 517, então uma faixa que resolve para uma conta pode legitimamente falhar para outra. Consulte o id em vez de presumir que um id armazenado ainda funciona.

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

Pesquisar uma faixa

Anexar a faixa a um Reel