JioSaavn API v1
JioSaavn API implemented in Python using Flask
Features:
Currently the API can serve the following queries:
- Search for Songs
- Details of a Song with download URL
- .... a lot will be added in future
Usage:
- Searching Songs: /search?q=photograph&n=2&page_num=1
- Parameters
- q: query [required]
- n: number of songs [default: 20]
- page_num: page number of response [default: 1]
- Response
{ "results": [ { "artists": "Ed Sheeran", "id": "CBGvoIP8", "image": "https://c.saavncdn.com/835/x-English-2014-150x150.jpg", "title": "Photograph" }, { "artists": "Ed Sheeran", "id": "td4mU-9E", "image": "https://c.saavncdn.com/748/Photograph-Felix-Jaehn-Remix-English-2015-150x150.jpg", "title": "Photograph (Felix Jaehn Remix)" } ], "start": 1, "total": 3179 }
- Parameters
- Song Details: /details/song?id=CBGvoIP8
- Parameters
- id: id of song [required]
- Response
{ "album": "x", "album_url": "https://www.jiosaavn.com/album/x/dZ9OOF6Jq4o_", "albumid": "1188602", "duration": "258", "id": "CBGvoIP8", "image": "https://c.saavncdn.com/835/x-English-2014-500x500.jpg", "language": "english", "media_url": "https://sdlhivkecdnems01.cdnsrv.jio.com/h.saavncdn.com/835/2d0cf8c83a9f3b900ac214e21d07badc_320.mp4", "play_count": 9147693, "release_date": "2014-06-20", "singers": "Ed Sheeran", "song": "Photograph", "year": "2014" }
- Parameters
Installation:
Clone this repository using
$ git clone https://github.com/priyansh-anand/JioSaavnAPI
Enter into the directory and install all the requirements using
$ cd JioSaavnAPI
$ pip3 install -r requirements.txt
Run the app using
$ python3 app.py
Note: This flask application is being served with the development server provided with Flask, if you want to deploy it on Heroku or on any server, then use a production server such as Gunicorn.
License
MIT Free Software, Hell Yeah!
Contribution
If you want to add any new feature or fix any bug, you are welcomed to do that. You can also request/suggest for more awesome features to be added in this API