Lyrics 🎤

Busca de letras de músicas

Buscar Letra

POST/api/lyrics/search

Busca a letra de uma música por artista e título.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
artist	string	Sim	Nome do artista
title	string	Sim	Título da música

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/lyrics/search \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "artist": "The Weeknd",
    "title": "Blinding Lights"
  }'

JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/lyrics/search', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    artist: 'The Weeknd',
    title: 'Blinding Lights'
  })
});

const data = await response.json();
console.log(data.data.lyrics);

Resposta

json

{
  "success": true,
  "data": {
    "artist": "The Weeknd",
    "title": "Blinding Lights",
    "lyrics": "I've been tryna call\nI've been on my own for long enough...",
    "album": "After Hours",
    "release_date": "2019-11-29",
    "cover": "https://images.genius.com/...",
    "genius_url": "https://genius.com/The-weeknd-blinding-lights-lyrics",
    "language": "en"
  }
}

Custo: 1 crédito por requisição

Buscar Sugestões

POST/api/lyrics/suggestions

Busca sugestões de músicas via Genius a partir de uma query de texto.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
query	string	Sim	Texto de busca (nome da música, artista, trecho)

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/lyrics/suggestions \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Blinding Lights"
  }'

Resposta

json

{
  "success": true,
  "data": {
    "suggestions": [
      {
        "title": "Blinding Lights",
        "artist": "The Weeknd",
        "genius_url": "https://genius.com/The-weeknd-blinding-lights-lyrics",
        "cover": "https://images.genius.com/..."
      },
      {
        "title": "Blinding Lights (Remix)",
        "artist": "The Weeknd & Rosalía",
        "genius_url": "https://genius.com/The-weeknd-and-rosalia-blinding-lights-remix-lyrics",
        "cover": "https://images.genius.com/..."
      }
    ]
  }
}

Custo: 1 crédito por requisição

Busca em Lote

POST/api/lyrics/batch

Busca letras de múltiplas músicas de uma vez. Máximo de 10 músicas por requisição.

🔒 Apenas planos PRO e PREMIUM

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
songs	object[]	Sim	Array de objetos {artist, title} (máx. 10)

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/lyrics/batch \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "songs": [
      { "artist": "The Weeknd", "title": "Blinding Lights" },
      { "artist": "Adele", "title": "Hello" },
      { "artist": "Ed Sheeran", "title": "Shape of You" }
    ]
  }'

Resposta

json

{
  "success": true,
  "message": "Busca em lote realizada com sucesso",
  "data": {
    "results": [
      {
        "artist": "The Weeknd",
        "title": "Blinding Lights",
        "lyrics": "I've been tryna call...",
        "status": "success"
      },
      {
        "artist": "Adele",
        "title": "Hello",
        "lyrics": "Hello, it's me...",
        "status": "success"
      },
      {
        "artist": "Ed Sheeran",
        "title": "Shape of You",
        "lyrics": "The club isn't the best place...",
        "status": "success"
      }
    ],
    "total": 3,
    "successful": 3,
    "credits_remaining": 4997
  }
}

Custo: 1 crédito por música no lote

Recursos

✓
Busca por Artista e Título
Encontre letras com precisão usando artista e título da música
✓
Metadados do Genius
Álbum, data de lançamento, capa e link do Genius inclusos
✓
Múltiplos Idiomas
Suporte a letras em português, inglês, espanhol e outros idiomas

⚠️

Limitações

• Algumas músicas menos conhecidas podem não estar disponíveis
• O endpoint batch é exclusivo para planos PRO e PREMIUM

💡

Dica

Use o endpoint /suggestions para encontrar o artista e título corretos antes de buscar a letra completa.