Skip to content

Latest commit

 

History

History
129 lines (106 loc) · 4.43 KB

README.md

File metadata and controls

129 lines (106 loc) · 4.43 KB

jiosaavn-api

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/vendz/jiosaavn-api

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, Heroku or Vercel :)

Deploy to Vercel


⭐ the Repo in case you liked it :)

Made with ❤️ in India