Spotify Downloader API

Dokumentasi resmi Spotify Downloader API dari Maelyn API untuk mengambil informasi track Spotify dan mengunduh audio dalam format MP3

Base Information

BASE_URL_API: https://api.maelyn.eu/api
Path / Endpoint: /download/spotify
Method: POST
Credit Usage: 3

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY
Content-Type: application/json

Description

Endpoint ini digunakan untuk mengambil informasi track Spotify dan mengunduh audio dalam format MP3.

API akan memproses URL track Spotify dan mengembalikan:

file audio MP3
informasi track
metadata seperti title, artist, album, duration, cover, dan release date

Request Body

{
  "url": "https://open.spotify.com/track/4bCoqCjwZggHxHcUSRpFDG"
}

Body Parameters

Name	Type	Required	Description
`url`	`string`	Yes*	URL track Spotify
`link`	`string`	Yes*	Alternatif dari `url`

Salah satu dari url atau link wajib diisi.

Notes

Body request harus berupa JSON.
URL harus valid dan berasal dari Spotify.
Saat ini hanya mendukung URL dengan tipe track.
URL playlist, album, artist, atau podcast belum didukung.
Format output audio adalah MP3.
Proses download bisa memakan waktu lebih lama tergantung durasi track dan kondisi server.
Endpoint ini menggunakan sistem queue untuk menjaga stabilitas server.

Example Usage

1. Download MP3 dari URL track Spotify

{
  "url": "https://open.spotify.com/track/4bCoqCjwZggHxHcUSRpFDG"
}

2. Menggunakan parameter alternatif `link`

{
  "link": "https://open.spotify.com/track/4bCoqCjwZggHxHcUSRpFDG"
}

Success Response

{
  "success": true,
  "message": "Berhasil mengambil info dan MP3 Spotify",
  "result": {
    "id": "4bCoqCjwZggHxHcUSRpFDG",
    "title": "Mrs Magic - Piano Version",
    "artist": "Piano Glow",
    "artists": [
      "Piano Glow"
    ],
    "album": {
      "images": [
        {
          "url": "https://i.scdn.co/image/ab67616d00001e02bd97b551413558baf1819a5a"
        }
      ]
    },
    "duration_ms": 211750,
    "popularity": null,
    "explicit": null,
    "preview_url": null,
    "cover": "https://i.scdn.co/image/ab67616d00001e02bd97b551413558baf1819a5a",
    "release_date": null,
    "spotify_url": "https://open.spotify.com/track/4bCoqCjwZggHxHcUSRpFDG",
    "format": "mp3",
    "url": "https://static-storage.maelyn.eu/proxy/832ebc76-8fd8-463a-a383-7409c55c21c9.mp3",
    "size_bytes": 8504407,
    "content_type": "audio/mpeg",
    "filename": "832ebc76-8fd8-463a-a383-7409c55c21c9.mp3"
  }
}

Response Fields

Field	Type	Description
`success`	`boolean`	Status request
`message`	`string`	Pesan hasil request
`result`	`object`	Hasil proses Spotify downloader
`id`	`string`	ID track Spotify
`title`	`string`	Judul track
`artist`	`string`	Nama artist dalam bentuk teks
`artists`	`array`	Daftar artist
`album`	`object`	Informasi album jika tersedia
`duration_ms`	`number`	Durasi track dalam milidetik
`popularity`	`number`	Nilai popularitas track jika tersedia
`explicit`	`boolean`	Status explicit track jika tersedia
`preview_url`	`string`	URL preview audio jika tersedia
`cover`	`string`	URL cover/thumbnail track
`release_date`	`string`	Tanggal rilis track jika tersedia
`spotify_url`	`string`	URL Spotify track
`format`	`string`	Format file audio
`url`	`string`	URL file MP3 hasil download
`size_bytes`	`number`	Ukuran file dalam bytes
`content_type`	`string`	MIME type file audio
`filename`	`string`	Nama file audio

Error Response

Invalid JSON

{
  "success": false,
  "message": "Body JSON tidak valid"
}

URL Required

{
  "success": false,
  "message": "url wajib diisi"
}

Invalid Spotify URL

{
  "success": false,
  "message": "URL Spotify tidak valid. Saat ini hanya support URL track Spotify"
}

Internal Server Error

{
  "success": false,
  "message": "Internal server error"
}

Playground

Threads Mediafire