JioSaavn API [Unofficial]

Show some ❤️ and ⭐ the repo to support the project

JioSaavn API written in Python using Flask

NOTE: You don't need to have JioSaavn link of the song in order to fetch the song details, you can directly search songs by their name. Fetching Songs/Albums/Playlists from URL is also supported in this API.

Features:

Currently the API can get the following details for a specific song in JSON format:

Song Name
Singer Name
Album Name
Album URL
Duration of Song
Song Thumbnail URL (Max Resolution)
Song Language
Download Link
Release Year
Album Art Link (Max Resolution)
Lyrics
.... and much more!

{
    "album": "BIBA",
    "album_url": "https://www.jiosaavn.com/album/biba/98G3uzIs2qQ_",
    "autoplay": "false",
    "duration": "175",
    "e_songid": "ICERW0MFfQs",
    "has_rbt": "false",
    "image_url": "https://c.saavncdn.com/987/BIBA-English-2019-20190201201359-500x500.jpg",
    "label": "Joytime Collective",
    "label_url": "/label/joytime-collective-albums/",
    "language": "hindi",
    "liked": "false",
    "map": "Marshmello^~^/artist/marshmello-songs/Eevs5FiVgus_^~^Pritam Chakraborty^~^/artist/pritam-chakraborty-songs/OaFg9HPZgq8_^~^Shirley Setia^~^/artist/shirley-setia-songs/9qGdjoPJ1vM_^~^Pardeep Singh Sran^~^/artist/pardeep-singh-sran-songs/NIfiZRCrYQA_^~^Dev Negi^~^/artist/dev-negi-songs/NpCqdI4dD5U_",
    "music": "",
    "origin": "search",
    "origin_val": "biba",
    "page": 1,
    "pass_album_ctx": "true",
    "perma_url": "https://www.jiosaavn.com/song/biba/ICERW0MFfQs",
    "publish_to_fb": true,
    "singers": "Marshmello, Pritam Chakraborty, Shirley Setia, Pardeep Singh Sran, Dev Negi",
    "songid": "PIzj75J8",
    "starred": "false",
    "starring": "",
    "streaming_source": null,
    "tiny_url": "https://www.jiosaavn.com/song/biba/ICERW0MFfQs",
    "title": "BIBA",
    "twitter_url": "http://twitter.com/share?url=https%3A%2F%2Fwww.jiosaavn.com%2Fsong%2Fbiba%2FICERW0MFfQs&text=%23NowPlaying+%22BIBA%22+%40jiosaavn+%23OurSoundtrack&related=jiosaavn",
    "url": "http://h.saavncdn.com/987/cd902d048c13e5ce6ca84cc409746a5d.mp3",
    "year": "2019"
  }

Installation:

Clone this repository using

$ git clone https://github.com/cyberboysumanjay/JioSaavnAPI

Enter the directory and install all the requirements using

$ pip3 install -r requirements.txt

Run the app using

$ python3 app.py

Navigate to 127.0.0.1:5000 to see the Homepage

Usage:

Fetching lyrics is optional and is triggered only when it is passed as an argument in the GET Request. (&lyrics=true) If you enable lyrics search, it will take more time to fetch results

Universal Endpoint: (Supports Song Name, Song Link, Album Link, Playlist Link)

http://127.0.0.1:5000/result/?query=<insert-jiosaavn-link-or-query-here>&lyrics=true

Example: Navigate to http://127.0.0.1:5000/result/?query=alone to get a JSON response of songs data in return.

Song URL Endpoint:

http://127.0.0.1:5000/song/?query=<insert-jiosaavn-song-link>&lyrics=true

Example: Navigate to http://127.0.0.1:5000/song/?query=https://www.jiosaavn.com/song/khairiyat/PwAFSRNpAWw to get a JSON response of song data in return.

Playlist URL Endpoint:

http://127.0.0.1:5000/playlist/?query=<insert-jiosaavn-playlist-link>&lyrics=true

Example: Navigate to http://127.0.0.1:5000/playlist/?query=https://www.jiosaavn.com/featured/romantic-hits-2020---hindi/ABiMGqjovSFuOxiEGmm6lQ__ to get a JSON response of playlist data in return.

Album URL Endpoint:

http://127.0.0.1:5000/album/?query=<insert-jiosaavn-album-link>&lyrics=true

Example: Navigate to http://127.0.0.1:5000/album/?query=https://www.jiosaavn.com/album/chhichhore/V4F3M5,cNb4_ to get a JSON response of album data in return.

Lyrics Endpoint:

http://127.0.0.1:5000/lyrics/?query=<insert-jiosaavn-song-link-or-song-id>&lyrics=true

Example: Navigate to http://127.0.0.1:5000/lyrics/?query=https://www.jiosaavn.com/song/khairiyat/PwAFSRNpAWw to get a JSON response of lyrics data in return.

You can fork the repo and deploy on VPS or deploy it on Heroku :)

Note: Heroku gives US/Europe servers which won't be able to fetch all songs flawlessly. Use any Indian VPS for accurate results.

This is forked repo original repo is this one

winteruser1303 / jiosaavnapi Goto Github PK

jiosaavnapi's Introduction