{"id":16966937,"url":"https://github.com/cyberboysumanjay/jiosaavnapi","last_synced_at":"2025-04-04T16:17:21.275Z","repository":{"id":40680536,"uuid":"199725109","full_name":"cyberboysumanjay/JioSaavnAPI","owner":"cyberboysumanjay","description":"An unofficial API for JioSaavn written in Python 3","archived":false,"fork":false,"pushed_at":"2024-08-08T19:57:20.000Z","size":48,"stargazers_count":360,"open_issues_count":14,"forks_count":181,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-10-15T00:06:36.936Z","etag":null,"topics":["api","downloadermp3","flask","flask-api","flask-application","jio","jio-saavn","jiosaavn","jiosaavn-downloader","mp3","music","python","python3","saavn","stream","streaming-api","streaming-audio"],"latest_commit_sha":null,"homepage":"https://saavnapi-nine.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cyberboysumanjay.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-30T20:48:22.000Z","updated_at":"2024-09-20T07:54:49.000Z","dependencies_parsed_at":"2022-08-10T00:40:41.864Z","dependency_job_id":"6cf4f5fd-e925-4ba1-a31a-05ca40eea7b8","html_url":"https://github.com/cyberboysumanjay/JioSaavnAPI","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberboysumanjay%2FJioSaavnAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberboysumanjay%2FJioSaavnAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberboysumanjay%2FJioSaavnAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberboysumanjay%2FJioSaavnAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyberboysumanjay","download_url":"https://codeload.github.com/cyberboysumanjay/JioSaavnAPI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208190,"owners_count":20901570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","downloadermp3","flask","flask-api","flask-application","jio","jio-saavn","jiosaavn","jiosaavn-downloader","mp3","music","python","python3","saavn","stream","streaming-api","streaming-audio"],"created_at":"2024-10-14T00:06:39.866Z","updated_at":"2025-04-04T16:17:21.256Z","avatar_url":"https://github.com/cyberboysumanjay.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## JioSaavn API [Unofficial]\n\n### Show some :heart: and :star: the repo to support the project\n\n[![GitHub stars](https://img.shields.io/github/stars/cyberboysumanjay/jiosaavnapi.svg?style=social\u0026label=Star)](https://github.com/cyberboysumanjay/JioSaavnAPI) ![GitHub followers](https://img.shields.io/github/followers/cyberboysumanjay.svg?style=social\u0026label=Follow)\n[![Telegram Channel](https://img.shields.io/badge/Telegram-Channel-orange)](https://t.me/sjprojects)\n[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/) [![Open Source Love svg1](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)\n\n#### JioSaavn API written in Python using Flask  \n\n ---\n###### **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.  \n\n ---\n\n### **Features**:\n##### Currently the API can get the following details for a specific song in JSON format:\n- **Song Name**\n- **Singer Name**\n- **Album Name**\n- **Album URL**\n- **Duration of Song**\n- **Song Thumbnail URL (Max Resolution)**\n- **Song Language**\n- **Download Link**\n- **Release Year**\n- **Album Art Link (Max Resolution)**\n- **Lyrics**\n- .... and much more!\n\n```json\n{\n    \"album\": \"BIBA\",\n    \"album_url\": \"https://www.jiosaavn.com/album/biba/98G3uzIs2qQ_\",\n    \"autoplay\": \"false\",\n    \"duration\": \"175\",\n    \"e_songid\": \"ICERW0MFfQs\",\n    \"has_rbt\": \"false\",\n    \"image_url\": \"https://c.saavncdn.com/987/BIBA-English-2019-20190201201359-500x500.jpg\",\n    \"label\": \"Joytime Collective\",\n    \"label_url\": \"/label/joytime-collective-albums/\",\n    \"language\": \"hindi\",\n    \"liked\": \"false\",\n    \"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_\",\n    \"music\": \"\",\n    \"origin\": \"search\",\n    \"origin_val\": \"biba\",\n    \"page\": 1,\n    \"pass_album_ctx\": \"true\",\n    \"perma_url\": \"https://www.jiosaavn.com/song/biba/ICERW0MFfQs\",\n    \"publish_to_fb\": true,\n    \"singers\": \"Marshmello, Pritam Chakraborty, Shirley Setia, Pardeep Singh Sran, Dev Negi\",\n    \"songid\": \"PIzj75J8\",\n    \"starred\": \"false\",\n    \"starring\": \"\",\n    \"streaming_source\": null,\n    \"tiny_url\": \"https://www.jiosaavn.com/song/biba/ICERW0MFfQs\",\n    \"title\": \"BIBA\",\n    \"twitter_url\": \"http://twitter.com/share?url=https%3A%2F%2Fwww.jiosaavn.com%2Fsong%2Fbiba%2FICERW0MFfQs\u0026text=%23NowPlaying+%22BIBA%22+%40jiosaavn+%23OurSoundtrack\u0026related=jiosaavn\",\n    \"url\": \"http://h.saavncdn.com/987/cd902d048c13e5ce6ca84cc409746a5d.mp3\",\n    \"year\": \"2019\"\n  }\n```\n\n### **Installation**:\n\nClone this repository using\n```sh\n$ git clone https://github.com/cyberboysumanjay/JioSaavnAPI\n```\nEnter the directory and install all the requirements using\n```sh\n$ pip3 install -r requirements.txt\n```\nRun the app using\n```sh\n$ python3 app.py\n```\nNavigate to 127.0.0.1:5000 to see the Homepage\n\n### **Usage**:\nFetching lyrics is optional and is triggered only when it is passed as an argument in the GET Request. (**\u0026lyrics=true**)\n**If you enable lyrics search, it will take more time to fetch results**\n\n---\n##### **Universal Endpoint**: (Supports Song Name, Song Link, Album Link, Playlist Link)\n```sh\nhttp://127.0.0.1:5000/result/?query=\u003cinsert-jiosaavn-link-or-query-here\u003e\u0026lyrics=true\n```\n**Example:** Navigate to http://127.0.0.1:5000/result/?query=alone to get a JSON response of songs data in return.\n\n----\n\n\n##### **Song URL Endpoint**:\n```sh\nhttp://127.0.0.1:5000/song/?query=\u003cinsert-jiosaavn-song-link\u003e\u0026lyrics=true\n```\n**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.\n\n---\n\n##### **Playlist URL Endpoint**:\n```sh\nhttp://127.0.0.1:5000/playlist/?query=\u003cinsert-jiosaavn-playlist-link\u003e\u0026lyrics=true\n```\n**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.\n\n---\n\n##### **Album URL Endpoint**:\n```sh\nhttp://127.0.0.1:5000/album/?query=\u003cinsert-jiosaavn-album-link\u003e\u0026lyrics=true\n```\n**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.\n\n---\n\n##### **Lyrics Endpoint**:\n```sh\nhttp://127.0.0.1:5000/lyrics/?query=\u003cinsert-jiosaavn-song-link-or-song-id\u003e\u0026lyrics=true\n```\n**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.\n\n---\n\n#### You can fork the repo and deploy on VPS or deploy it on Heroku :)  \n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/cyberboysumanjay/JioSaavnAPI/tree/master)\n\n**Note:** Heroku gives US/Europe servers which won't be able to fetch all songs flawlessly. Use any Indian VPS for accurate results.\n\n---\n\n## **Made using this API** :heart:\n#### [Musify](https://github.com/Harsh-23/Musify/releases) - Android App\n#### [@songdl_bot](https://telegram.dog/songdl_bot) - Song Downloader Bot on Telegram\n#### [Jio-Saavn-Downloader [Beta]](https://jiosaavn.netlify.app/) - [Open Sourced](https://github.com/ParveenBhadooOfficial/Jio-Saavn-Downloader) website made by [Praveen Bhadoo](https://github.com/ParveenBhadooOfficial)\n#### [Musicder](https://musicder.tk/) - [Open Sourced](https://github.com/cachecleanerjeet/Musicder) website made by [Tuhin Pal](https://github.com/cachecleanerjeet)\n#### [Music_Downloader_CLI](https://github.com/thehamkercat/Music_Downloader_CLI) made by [TheHamkerCat](https://github.com/thehamkercat)\n#### Star the Repo in case you liked it :)\n\n### © [Sumanjay](https://cyberboysumanjay.github.io)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberboysumanjay%2Fjiosaavnapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyberboysumanjay%2Fjiosaavnapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberboysumanjay%2Fjiosaavnapi/lists"}