SpotiFetch API Docs

🔑 Autentikasi & Password Protection

Sistem proteksi password dikonfigurasi melalui variabel SITE_PASSWORD di file .env. Bila dikosongkan, seluruh endpoint dapat diakses secara terbuka (publik).

Jika password diaktifkan, Anda dapat mengirim token melalui salah satu metode berikut:

• Query string: ?apikey=YOUR_KEY atau ?password=YOUR_KEY
• HTTP Header: x-auth-token: YOUR_KEY
• HTTP Header: Authorization: Bearer YOUR_KEY

Mencari lagu di katalog resmi Spotify. Mengembalikan daftar track dengan judul resmi, artis resmi, durasi, cover album asli Spotify (i.scdn.co), dan link track Spotify asli.

curl -X GET "http://localhost:8000/search/track?q=Bruno+Mars+Risk+It+All&limit=2"

const res = await fetch('http://localhost:8000/search/track?q=Bruno+Mars+Risk+It+All&limit=2');
const data = await res.json();
console.log(data);

import requests

res = requests.get('http://localhost:8000/search/track', params={'q': 'Bruno Mars Risk It All', 'limit': 2})
print(res.json())

Mencari album musik di Spotify. Mengembalikan judul album, artis, tanggal rilis, total track, dan cover album.

Mencari profil artis di katalog Spotify dengan rincian jumlah followers, popularitas, genre, dan foto avatar.

Mencari playlist publik di Spotify dengan rincian nama pemilik playlist, total lagu, sampul, dan external URL.

Mengambil metadata resmi lagu Spotify dan menghasilkan link download audio MP3 kualitas tinggi (320 kbps). File MP3 secara otomatis disematkan tag ID3 resmi (Judul, Artis, Album, Tahun) serta gambar cover resolusi tinggi.

curl -X GET "http://localhost:8000/download/track?url=https://open.spotify.com/track/5y2ijHECwFYWqcAHKTZgzD"

// Langsung simpan file MP3 dengan parameter download=true
fetch('http://localhost:8000/download/track?url=https://open.spotify.com/track/5y2ijHECwFYWqcAHKTZgzD&download=true')
  .then(res => res.blob())
  .then(blob => {
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'Lagu.mp3';
    a.click();
  });

Mengunduh seluruh lagu dalam suatu album Spotify sekaligus dan mengemasnya ke dalam sebuah berkas ZIP rapi. Semua file MP3 di dalam ZIP telah diberi nomor urut dan metadata resmi.

# Mengambil link unduh berkas ZIP Album
curl -X GET "http://localhost:8000/download/album?id=4m2880jivSbbyEGAKfITCa"

Mengunduh seluruh lagu dalam suatu playlist Spotify secara otomatis dan mengemasnya ke dalam sebuah berkas ZIP rapi beresolusi 320 kbps dengan tag ID3 resmi.

curl -X GET "http://localhost:8000/download/playlist?id=3MPY6XJg5AUiLRaABByYn6"

const res = await fetch('http://localhost:8000/download/playlist?id=3MPY6XJg5AUiLRaABByYn6');
const data = await res.json();
console.log('ZIP URL:', data.result.download);

Mencari lagu di Spotify berdasarkan kata kunci q dan langsung menyiapkan link download/stream MP3. Sangat praktis untuk bot musik yang ingin mencari dan memutar lagu hanya dalam satu kali request.

Resolver universal untuk tautan Spotify apapun. Sistem akan secara otomatis mendeteksi apakah tautan bertipe track, album, artist, atau playlist dan mengembalikan metadata lengkapnya.

Endpoint streaming audio dengan dukungan HTTP 206 Partial Content (Range requests). Memungkinkan browser atau aplikasi pemutar audio melakukan pemutaran instan tanpa lag dan melakukan seeking (maju/mundur) durasi secara mulus.

Endpoint pengunduhan berkas langsung (Direct Download) untuk file MP3 atau arsip ZIP dengan header Content-Disposition: attachment.

Mengambil rincian metadata resmi lagu dari katalog Spotify berdasarkan Spotify Track ID (22 karakter) atau URL lagu.

Mengambil informasi lengkap album musik Spotify beserta seluruh daftar lagu (tracklist) di dalamnya.

Mengambil rincian profil artis Spotify beserta 10 lagu terpopuler (Top Tracks) artis tersebut.

Mengambil rincian playlist Spotify beserta seluruh daftar lagu (tracklist) di dalamnya.

Mengambil lirik lagu lengkap baik dalam format teks biasa maupun lirik tersinkronisasi (synced / karaoke) dengan timestamp detik. Mendukung query via Spotify Track ID atau langsung judul lagu & nama artis.

curl -X GET "http://localhost:8000/lyrics?title=Locked+out+of+Heaven&artist=Bruno+Mars"

const res = await fetch('http://localhost:8000/lyrics?title=Locked+out+of+Heaven&artist=Bruno+Mars');
const data = await res.json();
console.log(data);

import requests

res = requests.get('http://localhost:8000/lyrics', params={'title': 'Locked out of Heaven', 'artist': 'Bruno Mars'})
print(res.json())

Mengunduh berkas lirik lagu langsung sebagai file .lrc (synced karaoke) atau berkas .txt (plain text) dengan header download otomatis.