Acesse letras em tempo real do Apple Music para uma experiência de audição aprimorada
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/13664/apple+music+lyrics+fetcher+api/31105/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 Apple Music Fetcher de Letras 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 Apple Music Lyrics Fetcher fornece cargas de letras prontas para produção para aplicativos que precisam de mais do que texto simples. Para uma determinada faixa, ela retorna uma resposta JSON estruturada combinando metadados da música, conteúdo lírico cronometrado e múltiplos formatos de exportação para que você possa viabilizar visualizações de karaokê, legendas sincronizadas ou telas de letras ao estilo Apple Music sem precisar reconstruir a lógica de tempo 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 cronometradas 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 ao nível de palavra ou sílaba para que cada fragmento possa se iluminar à medida que o áudio toca. As linhas também podem conter texto de vocal de fundo, bandeiras de turnos opostos, IDs de agentes e limites de seção para layouts de interface do usuário mais ricos.
A API Apple Music Lyrics Fetcher retorna dados JSON estruturados que incluem letras de músicas sincronizadas metadados da música e múltiplos formatos de exportação (LRC/eLRC/TTML) Esses dados são projetados para aplicações que requerem letras sincronizadas para karaokê ou exibições de letras
Campos-chave na resposta incluem "metadados" (com compositores, idioma, duração), "conteúdo" (linhas temporizadas com carimbos de tempo, 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 endpoint fornece informações como compositores, idioma, duração, silêncio inicial e conteúdo detalhado da letra com timestamps, rótulos de estrutura (por exemplo, Verso, Refrão) e dados do agente vocal, permitindo implementações ricas de UI
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 Este 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 estruturado 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 aumento do 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 musical da Apple Music que passa por verificações de qualidade para garantir que as letras e metadados estejam corretos e atualizados fornecendo conteúdo confiável para desenvolvedores
