spotidownloader/README.md

A lightweight API to fetch Spotify track details and provide direct download links.

# 🎵 Spotidownloader – Download Spotify Tracks Easily  

A simple and lightweight Spotify track downloader using an unofficial API.  
Fetch **Spotify track details** and get a **direct MP3 download link** with just one function call!  

🚀 **Fast** | 🎧 **Easy to Use** | 🔗 **No Extra Setup**  

---

## 📖 Table of Contents  
- [📌 Installation](#-installation)  
- [🔥 Usage Example](#-usage-example)  
- [🎧 Features](#-features)  
- [⚡ API Response](#-api-response)  
- [❗ Notes](#-notes)  
- [📜 License](#-license)  
- [👤 About the Developer](#-about-the-developer)  

---

## 📌 Installation  
Install via NPM:  
```sh
npm install spotidownloader
```
Make sure you have **Node.js** installed before using the package.  

---

## 🔥 Usage Example  
Here’s a quick example of how to use **Spotidownloader** in your Node.js project:

```js
const SpotifyDL = require('spotidownloader');

(async () => {
    const track = await SpotifyDL.get('https://open.spotify.com/track/7eRieAYqAG7rBEOMlvR0xy');

    if (track.error) {
        console.error('Error:', track.error);
    } else {
        console.log('🎶 Track Info:', track);
        console.log('📥 Download Link:', track.download);
    }
})();
```

---

## 🎧 Features  
✔ **Fetch Track Info** – Get song title, artist, album, cover image, release date, and duration.  
✔ **Direct MP3 Download** – Instantly grab the MP3 file.  
✔ **Lightweight & Fast** – No unnecessary dependencies.  
✔ **Simple API** – Just call `.get(url)` and receive track details.  

---

## ⚡ API Response  
Here’s what you get when you fetch a track:  
```json
{
  "title": "In Lab",
  "artist": "Blakdyak",
  "album": "Noon at Ngayon",
  "cover": "https://i.scdn.co/image/ab67616d0000b273b710265f2f2ff055cc0c9a10",
  "released": "1997",
  "duration": 198,
  "download": "http://spotifydl-api.gleeze.com/5f7839ea1782"
}
```
- **`title`** – Name of the song  
- **`artist`** – Artist(s) of the track  
- **`album`** – Album name  
- **`cover`** – Album cover image URL  
- **`released`** – Year of release  
- **`duration`** – Length of the song in seconds  
- **`download`** – Direct MP3 download link  

---

## ❗ Notes  
- This tool **does not bypass any restrictions** and only works with an **unofficial API**.  
- The download link is generated by a third-party service.  
- Some tracks **may not be available for download** due to licensing restrictions.  

---

## 📜 License  
This project is **open-source** and licensed under the **MIT License**.  

---

## 👤 About the Developer  
Developed with ❤️ by **JrDev06**  
📌 Facebook: [JrDev06](https://www.facebook.com/jr.busaco.271915)  

If you find this package useful, **consider following me on Facebook, it helps a lot!**