🎵 Jio Saavn API

A simple wrapper for the Jio Saavn API powered by Hono.js 🔥.

📚 Documentation (Scalar UI) · OpenAPI JSON

✨ Features

• 🚀 Ultrafast - Powered by Hono.js.The router RegExpRouter is really fast.
• 🪶 Lightweight - Has minimal dependencies.
• 🌍 Multi-runtime - Works on Bun, Node.js, Vercel, and Cloudflare Workers.
• 🔥 Download High Quality Songs, w/ lyrics for supported songs.
• 🎵 Get Songs, Albums, Playlists, Artists, Radio Stations, Podcasts Lyrics, Recommendations, and more.
• ❤️ Open Source

📚 API Documentation

• Scalar API Reference: GET /docs
• OpenAPI JSON: GET /openapi.json

🛠️ Building from source

• Clone the repository

git clone https://github.com/rajput-hemant/jiosaavn-api
cd jiosaavn-api

• Install dependencies

bun i || pnpm i || npm i || yarn

Bun

Warning

You need to have Bun.js installed on your machine to run the project with bun.

bun run dev || pnpm dev || npm run dev || yarn dev

🌐 Deploying your own instance

You can easily deploy your own hosted version of the JioSaavn API by clicking on one of the links below, which will set up a ready-to-go version for you:

Important

Deploy in an India region so all APIs work properly. Recommended region: Mumbai, India (South) - bom1

Note

For Cloudflare Workers, remove any process-related code before deploying.

Build and Run Docker Image

Docker Compose (Recommended)

• Start the container

docker-compose up -d # detached mode

• Stop the container

docker-compose stop # stops the container
docker-compose down # stops and removes the container

Docker

• Start Docker daemon (Skip if already running)

sudo dockerd

• Build the image

docker build -t jiosaavn .

• Run the image

docker run -p 80:3000 jiosaavn

• Open http://localhost to view it in the browser.

• Stop the container

docker ps

docker stop <container-id>

📜 License

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

🦾 Contributors: