GaanaPy is an unofficial JSON API for Gaana, an Indian Music Streaming Service.
Live API: https://gaana.boundary.ml
The API can get the following details for a specific track in JSON format (Other Options Include: Albums, Artists, Trending, New Releases and Playlists):
- Track Name
- Track Duration
- Track Artwork
- Track URL
- Track Language
- Artist Name
- Artist Artwork
- Album Name
- Album URL
- Album Artwork
- Direct m3u8 Stream URLS
- Release Date
- Top Charts
- Trending Tracks
- New Releases
- .... and a lot more!
[
{
"seokey": "tyler-herro",
"album_seokey": "tyler-herro",
"track_id": "32408795",
"title": "Tyler Herro",
"artists": "Jack Harlow",
"artist_seokeys": "jack-harlow",
"artist_image": "https://a10.gaanacdn.com/gn_img/artists/XYybzrb2gz/Yybzn4Bgb2/size_m_1607927137.webp",
"album": "Tyler Herro",
"duration": "02:36",
"genres": "Hip Hop",
"is_explicit": 1,
"language": "English",
"label": "Generation Now/Atlantic",
"release_date": "2020-10-22",
"play_count": "<100K",
"favorite_count": 202,
"song_url": "https://gaana.com/song/tyler-herro",
"album_url": "https://gaana.com/album/tyler-herro",
"images": {
"urls": {
"large_artwork": "https://a10.gaanacdn.com/gn_img/albums/4Z9bqo3yQn/Z9bq2AG1Ky/size_l.jpg",
"medium_artwork": "https://a10.gaanacdn.com/gn_img/albums/4Z9bqo3yQn/Z9bq2AG1Ky/size_m.jpg",
"small_artwork": "https://a10.gaanacdn.com/gn_img/albums/4Z9bqo3yQn/Z9bq2AG1Ky/size_s.jpg"
}
},
"stream_urls": {
"urls": {
"high_quality": "https://stream-cdn.gaana.com/songs/3/3487503/32408795/32408795_96.mp4.xvod/master.m3u8?sign=1656756551-MgfKD3auc3-0-b9f21d9ef627d1ec51c6d816268cc0ec",
"medium_quality": "https://stream-cdn.gaana.com/songs/3/3487503/32408795/32408795_64.mp4.xvod/master.m3u8?sign=1656756551-I1k1azFNJw-0-b111804c7ef97b484680be1d892d36d6",
"low_quality": "https://stream-cdn.gaana.com/songs/3/3487503/32408795/32408795_16.mp4.xvod/master.m3u8?sign=1656756551-I1k1azFNJw-0-b111804c7ef97b484680be1d892d36d6"
}
}
}
]Live Docs: https://gaana.boundary.ml/docs
https://gaana.boundary.ml/songs/search?query=<insert-query-here>&limit=<insert-limit-here, eg. 5>Example: Create a GET request or navigate to https://gaana.boundary.ml/songs/search?query=tyler herro to get a JSON response of song results in return.
https://gaana.boundary.ml/albums/search?query=<insert-query-here>&limit=<insert-limit-here, eg. 5>Example: Create a GET request or navigate to https://gaana.boundary.ml/albums/search?query=all over the place to get a JSON response of album results in return.
https://gaana.boundary.ml/artists/search?query=<insert-query-here>&limit=<insert-limit-here, eg. 5>Example: Create a GET request or navigate to https://gaana.boundary.ml/artists/search?query=KSI to get a JSON response of arist results in return.
https://gaana.boundary.ml/songs/info?seokey=SEOKEYHow do I find a song's seokey?:
- In a URL, for example,
https://gaana.com/song/tyler-herro,tyler-herrois the song's seokey. - Using
Search For Songs, locate:
[
{
"seokey": "tyler-herro",
}
]Example: Create a GET request or navigate to https://gaana.boundary.ml/songs/info?seokey=tyler-herro to get a JSON response of the song's info in return.
https://gaana.boundary.ml/albums/info?seokey=ALBUM_SEOKEYHow do I find an albums's seokey?:
- In a URL, for example,
https://gaana.com/album/tyler-herro,tyler-herrois the albums's seokey. - Using
Search For Albums, locate:
[
{
"seokey": "tyler-herro",
}
]- Using
Search For Songs, locate:
[
{
"album_seokey": "tyler-herro",
}
]Example: Create a GET request or navigate to https://gaana.boundary.ml/albums/info?seokey=tyler-herro to get a JSON response of the song's info in return.
https://gaana.boundary.ml/artists/info?seokey=SEOKEYHow do I find an artists's seokey?:
- In a URL, for example,
https://gaana.com/artist/jack-harlow,jack-harlowis the song's seokey. - Using
Search For SongsorSearch For Albums, locate:
[
{
"artist_seokeys": "jack-harlow", (There may be more than 1 seokey depending on the number of artists in the song.)
}
]Example: Create a GET request or navigate to https://gaana.boundary.ml/artists/info?seokey=jack-harlow to get a JSON response of the artists's info in return.
https://gaana.boundary.ml/playlists/info?seokey=SEOKEYHow do I find a playlists's seokey?:
- In a URL, for example,
https://gaana.com/playlist/gaana-dj-gaana-international-top-50,gaana-dj-gaana-international-top-50is the playlists's seokey.
Example: Create a GET request or navigate to https://gaana.boundary.ml/playlists/info?seokey=gaana-dj-gaana-international-top-50 to get a JSON response of the playlists's info in return.
https://gaana.boundary.ml/trending?lang=LANGUAGELanguage Options: English, Hindi, Punjabi, Telugu, Tamil etc. (Warning: Case Sensitive!). Defaults to Hindi if no language is provided or if an invalid language is entered.
Example: Create a GET request or navigate to https://gaana.boundary.ml/trending?lang=English to get a JSON response of the trending English songs in return.
https://gaana.boundary.ml/newreleases?lang=LANGUAGELanguage Options: English, Hindi, Punjabi, Telugu, Tamil etc. (Warning: Case Sensitive!). Defaults to Hindi if no language is provided or if an invalid language is entered.
Example: Create a GET request or navigate to https://gaana.boundary.ml/newreleases?lang=English to get a JSON response of both new English songs and English albums in return.
https://gaana.boundary.ml/chartsExample: Create a GET request or navigate to https://gaana.boundary.ml/charts to get a JSON response of the top charts.
Clone the Repository
$ git clone https://github.com/ZingyTomato/GaanaPyEnter /GaanaPy and install all the requirements using
$ pip3 install -r requirements.txtRun the app using
$ python3 -m uvicorn app:app --reloadNavigate to: http://127.0.0.1:8000 to get started.
Deploy the API locally using the following Docker-Compose stack:
---
version: "2.1"
services:
gaanapy:
image: zingytomato/gaanapy:main
container_name: gaanapy
ports:
- 8000:8000 # External port can be changed
restart: unless-stopped
Navigate to: http://SERVER_IP:8000 to get started.
Feel free to create an issue if you encounter any bugs or would like to suggest something!