Shazam 🎼

Identificação de músicas via reconhecimento de áudio

Identificar Música

POST/api/shazam/identify

Identifica uma música a partir de um arquivo de áudio.

Headers

Header	Valor
X-API-Key	sua_api_key_aqui
Content-Type	multipart/form-data

Body (Form Data)

Campo	Tipo	Descrição
audio	file	Arquivo de áudio (MP3, WAV, M4A, OGG)

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/shazam/identify \
  -H "X-API-Key: sua_api_key_aqui" \
  -F "audio=@/caminho/para/audio.mp3"

JavaScript (FormData)

javascript

const formData = new FormData();
formData.append('audio', audioFile); // audioFile é um File object

const response = await fetch('https://api.alauda.mz/api/shazam/identify', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui'
  },
  body: formData
});

const data = await response.json();
console.log(data.data.title, '-', data.data.artist);

Python (requests)

python

import requests

headers = {
    'X-API-Key': 'sua_api_key_aqui'
}

files = {
    'audio': open('audio.mp3', 'rb')
}

response = requests.post(
    'https://api.alauda.mz/api/shazam/identify',
    headers=headers,
    files=files
)

result = response.json()
print(f"{result['data']['title']} - {result['data']['artist']}")

Resposta de Sucesso

json

{
  "success": true,
  "message": "Música identificada com sucesso",
  "data": {
    "title": "Blinding Lights",
    "artist": "The Weeknd",
    "album": "After Hours",
    "release_date": "2020",
    "genre": "Synthpop",
    "cover_art": "https://i.scdn.co/image/ab67616d0000b273...",
    "spotify_url": "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
    "youtube_url": "https://youtube.com/watch?v=4NRXx6U8ABQ",
    "apple_music_url": "https://music.apple.com/...",
    "shazam_url": "https://www.shazam.com/track/...",
    "credits_remaining": 4720
  }
}

Resposta (Não Identificada)

json

{
  "success": false,
  "error": "Música não identificada",
  "message": "Não foi possível identificar a música. Tente com um áudio de melhor qualidade."
}

Custo: 100 créditos por identificação

Formatos de Áudio Suportados

🎵

MP3

🎵

WAV

🎵

M4A

🎵

OGG

Requisitos do Áudio

✓
Duração Mínima
Pelo menos 10 segundos de áudio
✓
Qualidade
Áudio claro sem muito ruído de fundo
✓
Tamanho Máximo
Até 10 MB por arquivo
✓
Conteúdo
Deve conter música reconhecível (não apenas instrumentais ou sons ambiente)

Como Funciona

Upload do Áudio

Você envia um arquivo de áudio ou um trecho gravado

Análise

Nossa API processa o áudio e usa o Shazam para identificar a música

Resultado

Você recebe todas as informações da música: título, artista, álbum e links para streaming

Casos de Uso

🤖

Bots de Música

Identifique músicas enviadas pelos usuários em bots do WhatsApp, Telegram, Discord, etc.

📱

Apps Mobile

Adicione funcionalidade de reconhecimento de música em seu aplicativo

🎧

Playlists Automáticas

Crie playlists baseadas em músicas identificadas

📊

Analytics

Analise quais músicas estão sendo mais identificadas

⚠️

Importante

• Nem todas as músicas podem ser identificadas, especialmente remixes não oficiais
• Áudios com muito ruído ou muito curtos podem não ser reconhecidos
• O reconhecimento funciona melhor com gravações originais

💡

Dica Pro

Para melhores resultados, grave pelo menos 15-20 segundos do refrão da música em um ambiente silencioso.