A API de Letras do Apple Music retorna letras de músicas estruturadas e sincronizadas em nível de sílaba nos formatos LRC/eLRC/TTML, seções e metadados de múltiplos vocalistas para karaokê e interface de usuário do player
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/13593/apple+music+lyrics+api/30323/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 Letra 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 API de Letras do Apple Music fornece cargas de letras prontas para produção para aplicativos que precisam de mais do que texto simples. Para uma faixa específica, ela retorna uma resposta JSON estruturada combinando metadados da música, conteúdo de letra temporizado e múltiplos formatos de exportação para que você possa criar vistas de karaokê, legendas sincronizadas ou telas de letra no estilo do Apple Music sem ter que 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 versus vocais em destaque). O array de conteúdo principal divide a faixa em linhas temporizadas com carimbos de data e hora de início e fim, duração, rótulos de estrutura da canção, como Intro, Verso, Refrão ou Ponte, e intervalos de palavras ou sílabas para que cada fragmento possa acender conforme o áudio é reproduzido. As linhas também podem conter texto de vocais de fundo, bandeiras de viradas opostas, IDs de agentes e limites de seção para layouts de UI mais ricos.
A API de Letras do Apple Music retorna dados JSON estruturados que incluem letras de músicas temporizadas, metadados da música e múltiplos formatos de exportação (LRC/eLRC/TTML). Esses dados são projetados para aplicativos que requerem letras sincronizadas para karaoke ou exibições de letras
Os campos chave na resposta incluem "metadados" (com compositores, idioma, duração), "conteúdo" (linhas temporizadas com carimbos de hora, rótulos de estrutura) e "agentes" (representando vocalistas) Cada linha também contém fragmentos de texto com detalhes de timing
Os dados da resposta estão organizados em uma seção de "metadados" e uma matriz de "conteúdo" Os metadados fornecem informações gerais sobre a faixa enquanto a matriz de conteúdo divide as letras em segmentos cronometrados cada um com timestamps de início e fim e rótulos estruturais
O endpoint fornece informações como compositores, idioma, duração, silêncio inicial e conteúdo detalhado da letra com marcas de tempo, rótulos de estrutura (por exemplo, Verso, Refrão) e dados de 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 a letra e os metadados correspondentes
Os usuários podem utilizar os dados retornados para criar exibições de letras sincronizadas em aplicações 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
Casos de uso típicos incluem o desenvolvimento de aplicativos de karaokê a criação de recursos de exibição de letras em reprodutores de música e o aprimoramento do engajamento do usuário com letras sincronizadas durante a reprodução de música
A precisão dos dados é mantida através da fonte da extensa biblioteca de músicas da Apple Music, que passa por verificações de qualidade para garantir que as letras e os metadados estejam corretos e atualizados, fornecendo conteúdo confiável para os desenvolvedores
