JioSaavn for Python

from JioSaavn import search, search_songs, search_albums
from JioSaavn import search_artists, search_playlists, search_all

songs   = await search("Tum Hi Ho", limit=5)
songs   = await search_songs("Arijit Singh", limit=20, page=2)
albums  = await search_albums("Rockstar", limit=5)
artists = await search_artists("A.R. Rahman", limit=5)

# All 4 categories in one parallel call — NEW
results = await search_all("Pritam", limit=5)
print(results["songs"], results["albums"], results["artists"], results["playlists"])

from JioSaavn import get_song, get_songs, get_lyrics, get_suggestions, get_radio

# Single song with lyrics + decrypted 320kbps stream URL
song = await get_song("aRZbUYD7", lyrics=True)
print(song["media_url"])   # 320 kbps .mp4 stream, ready to play

# Batch fetch up to 50 songs in one call — NEW
tracks = await get_songs(["aRZbUYD7", "4ZSL1xJk", "FpxaLHiB"])

# Radio station seeded from a song — NEW
radio = await get_radio("aRZbUYD7", limit=15)
for t in radio:
    print(t["song"], t["media_url"])

# Similar song suggestions
recs = await get_suggestions("aRZbUYD7", limit=10)

from JioSaavn import get_song_by_url, get_album_by_url, get_playlist_by_url

# Paste any JioSaavn share link — no ID extraction needed
song     = await get_song_by_url("https://www.jiosaavn.com/song/tum-hi-ho/aRZbUYD7", lyrics=True)
album    = await get_album_by_url("https://www.jiosaavn.com/album/rockstar/OelUBDQMMXc_")
playlist = await get_playlist_by_url("https://www.jiosaavn.com/featured/top-50/AbCdEf12")

from JioSaavn import search_artists, get_artist, get_artist_top_songs, get_artist_top_albums

# Step 1: find the numeric artist ID
artists = await search_artists("Arijit Singh", limit=1)
aid     = artists[0]["id"]          # e.g. "459320"

# Step 2: full profile with top songs + albums
artist  = await get_artist(aid, n_song=10, n_album=5)
print(artist["name"], artist["follower_count"], artist["bio"])

# Paginate through all songs (page 2, sorted by latest)
page2   = await get_artist_top_songs(aid, page=2, category="latest")

from JioSaavn import get_trending, get_new_releases, get_top_searches
from JioSaavn import get_charts, get_featured_playlists, get_modules

trending  = await get_trending(language="hindi", limit=10)
releases  = await get_new_releases(language="punjabi", limit=5)
top_terms = await get_top_searches(limit=10)  # NEW

# All homepage data in one call — NEW
home = await get_modules(language="hindi", limit=8)
print(home["trending"])
print(home["new_releases"])
print(home["charts"])
print(home["featured_playlists"])

import asyncio
from JioSaavn import JioSaavnClient, search_all, get_charts, get_modules, get_trending

async def main():
    async with JioSaavnClient() as client:  # one shared aiohttp session
        results, charts, home, trending = await asyncio.gather(
            search_all("Arijit Singh", limit=5, client=client),
            get_charts(client=client),
            get_modules(language="hindi", client=client),
            get_trending(limit=10, client=client),
        )

asyncio.run(main())