Spotify 🎵

Busca e download de músicas do Spotify

Buscar Música

GET/api/spotify/search

Busca músicas no Spotify por nome, artista ou URL.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
query	string	Sim	Nome da música, artista ou URL

Exemplo de Requisição

bash

curl -X GET "https://api.alauda.mz/api/spotify/search?query=Blinding Lights" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "data": {
    "tracks": [
      {
        "id": "0VjIjW4GlUZAMYd2vXMi3b",
        "name": "Blinding Lights",
        "artist": "The Weeknd",
        "album": "After Hours",
        "duration": "3:20",
        "release_date": "2019-11-29",
        "cover": "https://i.scdn.co/image/ab67616d0000b273...",
        "spotify_url": "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
        "preview_url": "https://p.scdn.co/mp3-preview/..."
      }
    ]
  }
}

Custo: 10 créditos por busca

Download de Música

POST/api/spotify/download

Faz download da música em formato MP3 de alta qualidade.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
url	string	Sim	URL da música no Spotify

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/spotify/download \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b"
  }'

JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/spotify/download', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b'
  })
});

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

Resposta

json

{
  "success": true,
  "message": "Download realizado com sucesso",
  "data": {
    "download_url": "https://storage.alauda.mz/downloads/spotify/abc123.mp3",
    "title": "Blinding Lights",
    "artist": "The Weeknd",
    "album": "After Hours",
    "duration": "3:20",
    "cover": "https://i.scdn.co/image/ab67616d0000b273...",
    "format": "mp3",
    "quality": "320kbps",
    "size": "7.8 MB",
    "credits_remaining": 4900
  }
}

Custo: 50 créditos por download

Qualidade do Áudio

✓
Formato: MP3
Compatível com todos os dispositivos
✓
Bitrate: 320kbps
Alta qualidade de áudio
✓
Metadados Inclusos
Título, artista, álbum e capa

⚠️

Aviso Legal

Esta API deve ser usada apenas para fins educacionais e de teste. Respeite os direitos autorais e as políticas do Spotify.

💡

Dica

Use a busca primeiro para encontrar a URL correta da música antes de fazer o download.