Recupere facilmente as letras das músicas do Apple Music para enriquecer seus aplicativos de música
Executar no Postman
{
"type": "Syllable",
"metadata": {
"songwriters": [
"Martin Gore"
],
"language": "en",
"leadingSilence": 0,
"lyricOffset": null,
"audioRole": null,
"duration": 372901,
"agents": [
{
"id": "v1",
"type": "person"
}
],
"translations": [],
"transliterations": []
},
"content": [
{
"timestamp": 25760,
"endtime": 27767,
"duration": 2007,
"structure": "Verse",
"text": [
{
"text": "Words",
"timestamp": 25760,
"endtime": 26228,
"duration": 468,
"part": false
},
{
"text": "like",
"timestamp": 26228,
"endtime": 26640,
"duration": 412,
"part": false
},
{
"text": "violence",
"timestamp": 26640,
"endtime": 27767,
"duration": 1127,
"part": false
}
],
"background": false,
"backgroundText": [],
"oppositeTurn": false,
"agent": "v1",
"key": "L1",
"sectionBegin": 25760,
"sectionEnd": 42640
},
{
"timestamp": 27776,
"endtime": 29963,
"duration": 2187,
"structure": "Verse",
"text": [
{
"text": "Break",
"timestamp": 27776,
"endtime": 28400,
"duration": 624,
"part": false
},
{
"text": "the",
"timestamp": 28400,
"endtime": 28768,
"duration": 368,
"part": false
},
{
"text": "silence",
"timestamp": 28768,
"endtime": 29963,
"duration": 1195,
"part": false
}
],
"background": false,
"backgroundText": [],
"oppositeTurn": false,
"agent": "v1",
"key": "L2",
"sectionBegin": 25760,
"sectionEnd": 42640
},
{
"timestamp": 30357,
"endtime": 31938,
"duration": 1581,
"structure": "Verse",
"text": [
{
"text": "Come",
"timestamp": 30357,
"endtime": 30809,
"duration": 452,
"part": false
},
{
"text": "crashing",
"timestamp": 30809,
"endtime": 31275,
"duration": 466,
"part": false
},
{
"text": "in",
"timestamp": 31275,
"endtime": 31938,
"duration": 663,
"part": false
}
],
"background": false,
"backgroundText": [],
"oppositeTurn": false,
"agent": "v1",
"key": "L3",
"sectionBegin": 25760,
"sectionEnd": 42640
},
{
"timestamp": 31949,
"endtime": 34081,
"duration": 2132,
"structure": "Verse",
"text": [
{
"text": "Into",
"timestamp": 31949,
"endtime": 32580,
"duration": 631,
"part": false
},
{
"text": "my",
"timestamp": 32580,
"endtime": 32879,
"duration": 299,
"part": false
},
{
"text": "little",
"timestamp": 32879,
"endtime": 33336,
"duration": 457,
"part": false
},
{
"text": "world",
"timestamp": 33336,
"endtime": 34081,
"duration": 745,
"part": false
}
],
"background": false,
"backgroundText": [],
"oppositeTurn": false,
"agent": "v1",
"key": "L4",
"sectionBegin": 25760,
"sectionEnd": 42640
},
{
"timestamp": 34173,
"endtime": 36243,
"duration": 2070,
"structure": "Verse",
"text": [
{
"text": "Painful",
"timestamp": 34173,
"endtime": 34985,
"duration": 812,
"part": false
},
{
"text": "to",
"timestamp": 34985,
"endtime": 35438,
"duration": 453,
"part": false
},
{
"text": "me",
"timestamp": 35438,
"endtime": 36243,
"duration": 805,
"part": false
}
],
"background": false,
"backgroundText": [],
"oppositeTurn": false,
"agent": "v1",
"key": "L5",
"sectionBegin": 25760,
"sectionEnd": 42640
},
{
"timestamp": 36252,
"endtime": 38300,
"duration": 2048,
"structure": "Verse",
"text": [
{
"text": "Pierce",
"timestamp": 36252,
"endtime": 36904,
"duration": 652,
"part": false
},
{
"text": "right",
"timestamp": 36904,
"endtime": 37207,
"duration": 303,
"part": false
},
{
"text": "through",
"timestamp": 37207,
"endtime": 37543,
"duration": 336,
"part": false
},
{
"text": "me",
"timestamp": 37543,
"endtime": 38300,
"duration": 757,
"part": false
}
],
"background": false,
"backgroundText": [],
"oppositeTurn": false,
"agent": "v1",
"key": "L6",
"sectionBegin": 25760,
"sectionEnd": 42640
},
{
"timestamp": 38310,
"endtime": 40410,
"duration": 2100,
"structure": "Verse",
"text": [
{
"text": "Can't",
"timestamp": 38310,
"endtime": 38904,
"duration": 594,
"part": false
},
{
"text": "you",
"timestamp": 38904,
"endtime": 39218,
"duration": 314,
"part": false
},
{
"text": "understand?",
"timestamp": 39218,
"endtime": 40410,
"duration": 1192,
"part": false
}
],
"background": false,
"backgroundText": [],
"oppositeTurn": false,
"agent": "v1",
"key": "L7",
"sectionBegin": 25760,
"sectionEnd": 42640
},
{
"timestamp": 40543,
"endtime": 42640,
"duration": 2097,
"structure": "Verse",
"text": [
{
"text": "Oh,",
"timestamp": 40543,
"endtime": 41109,
"duration": 566,
"part": false
},
{
"text": "my",
"timestamp": 41109,
"endtime": 41424,
"duration": 315,
"part": false
},
{
"text": "little",
"timestamp": 41424,
"endtime": 41786,
"duration": 362,
"part": false
},
{
"text": "girl",
"timestamp": 41786,
"endtime": 42640,
"duration": 854,
"part": false
}
],
"background": false
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/13665/retrieve+lyrics+from+apple+music+api/31106/get+lyrics?id=1174246889' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Recuperar letras do Apple Music API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
A Recuperação de Letras da API do Apple Music fornece cargas de letras prontas para produção para aplicativos que precisam mais do que texto simples. Para uma faixa específica, ela retorna uma resposta JSON estruturada combinando metadados da música, conteúdo de letras temporizadas e múltiplos formatos de exportação, permitindo que você impulse visualizações de karaokê, legendas sincronizadas ou telas de letras ao estilo Apple Music sem a necessidade de reconstruir a lógica de temporização você mesmo.
Os metadados incluem compositores, idioma, duração, silêncio inicial e agentes opcionais que representam cantores ou papéis (por exemplo, vocais principais vs. vocais destacados). O array de conteúdo principal divide a faixa em linhas temporizadas com timestamps de início e fim, duração, rótulos de estrutura da música, como Introdução, Verso, Refrão ou Ponte, e intervalos de nível de palavra ou sílaba, de modo que cada fragmento possa ser iluminado à medida que o áudio é reproduzido. As linhas também podem carregar texto vocal de fundo, flags de mudança de verso, IDs de agentes e limites de seção para layouts de UI mais ricos.
A API Retrieve Lyrics da Apple Music retorna dados JSON estruturados que incluem letras de músicas temporizadas, metadados da música e vários formatos de exportação (LRC/eLRC/TTML) Esses dados são projetados para aplicativos que exigem letras sincronizadas para karaokê ou exibições de letras
Os campos-chave na resposta incluem "metadados" (com compositores, idioma, duração), "conteúdo" (linhas temporizadas com timestamps, rótulos de estrutura) e "agentes" (representando vocalistas) Cada linha também contém fragmentos de texto com detalhes de tempo
Os dados da resposta estão organizados em uma seção de "metadados" e um array de "conteúdo" Os metadados fornecem informações gerais sobre a faixa enquanto o array de conteúdo divide as letras em segmentos cronometrados cada um com timestamps de início e fim e rótulos estruturais
O ponto final fornece informações como compositores, idioma, duração, silêncio inicial e conteúdo lírico detalhado com marcas de tempo, rótulos de estrutura (por exemplo, Verso, Refrão) e dados do agente vocal permitindo implementações ricas de interface do usuário
O parâmetro principal para o endpoint é o ID da faixa que é o identificador numérico encontrado no final da URL da música do Apple Music Esse ID é essencial para recuperar as letras e os metadados correspondentes
Os usuários podem utilizar os dados retornados para criar exibições de letras sincronizadas em aplicativos, como interfaces de karaokê ou telas de letras. As informações de tempo estruturadas permitem uma sincronização precisa com a reprodução de áudio
Os casos de uso típicos incluem desenvolver aplicativos de karaokê criar recursos de exibição de letras em players de música e melhorar o engajamento do usuário com letras sincronizadas durante a reprodução de música
A precisão dos dados é mantida por meio da obtenção da extensa biblioteca de músicas da Apple Music que passa por verificações de qualidade para garantir que a letra e os metadados estejam corretos e atualizados fornecendo conteúdo confiável para os desenvolvedores
