Pular para o conteúdo principal
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.
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 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