🎵 JioSaavn UnOfficial API

A powerful and feature-rich wrapper for the JioSaavn API powered by Hono.js 🔥

📚 Documentation

📝 Attribution

This project is based on the excellent work of:

• saavn.dev - Original API implementation
• rajput-hemant - TypeScript implementation and enhancements

My contributions include:

• Enhanced documentation and API reference
• Improved error handling and response formats
• Additional endpoint implementations
• UI/UX improvements
• Code optimizations and bug fixes

✨ Features

• 🚀 Ultrafast - Powered by Hono.js. The router RegExpRouter is really fast.
• 🪶 Lightweight - Has minimal dependencies.
• 🌍 Multi-runtime - Works on Bun, Node.js, Vercel or Cloudflare Workers. The same code runs on all platforms.
• 🔥 High Quality Downloads - Download songs in multiple qualities (320kbps, 160kbps, 96kbps)
• 🎵 Comprehensive API - Access songs, albums, playlists, artists, radio stations, podcasts, lyrics, and recommendations
• 📱 Modern UI - Clean and responsive interface with beautiful documentation
• 🔍 Smart Search - Powerful search functionality across all content types
• 🌐 Language Support - Multi-language support for content and filters
• ❤️ Open Source - Free to use and modify under MIT license

🛠️ Getting Started

Prerequisites

• Node.js 16+ or Bun runtime
• npm, yarn, pnpm, or bun package manager

Installation

1. Clone the repository

git clone https://github.com/StrTux/JioSaavan-UnOfficial-Api
cd JioSaavan-UnOfficial-Api

2. Install dependencies

npm install   # or yarn, pnpm, bun install

3. Start the development server

Choose your preferred runtime:

Bun (Recommended)

bun run dev

Node.js

npm run dev:node

Vercel Dev Server

npm run dev:vc

Cloudflare Workers

npm run dev:cf

🚀 Deployment Options

Quick Deploy

Manual Deployment

Vercel

npm run deploy:vercel

Note: Recommended region: Mumbai, India (bom1) for optimal performance

Cloudflare Workers

npm run deploy:cf

Docker Deployment

Using Docker Compose (Recommended)

# Start
docker-compose up -d

# Stop
docker-compose down

Using Docker

# Build
docker build -t jiosaavn .

# Run
docker run -p 80:3000 jiosaavn

# Stop
docker stop <container-id>

📚 API Documentation

Full API documentation is available at docs-jiosaavn.netlify.app

Key endpoints include:

• Search API (/search)
• Songs API (/song)
• Albums API (/album)
• Playlists API (/playlist)
• Artists API (/artist)
• Lyrics API (/lyrics)
• Radio API (/radio)
• Downloads API (/download)

💡 Environment Variables

Create a .env file in the root directory:

PORT=3000
ENABLE_RATE_LIMIT=true

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Special thanks to:

• saavn.dev team for the original API implementation
• rajput-hemant for the TypeScript version and improvements
• All contributors who have helped improve this project

🦾 Contributors