SaavnAPI 2026.4.11__tar.gz

saavnapi-2026.4.11/JioSaavn/Core/Client.py

@@ -0,0 +1,16 @@
+from .Request import Request
+
+
+class JioSaavnClient:
+    def __init__(self):
+        self._req = Request()
+
+    async def __aenter__(self):
+        await self._req.__aenter__()
+        return self
+
+    async def __aexit__(self, *args):
+        await self._req.__aexit__(*args)
+
+    async def get(self, url):
+        return await self._req.get(url)

saavnapi-2026.4.11/JioSaavn/Core/Parser.py

@@ -0,0 +1,17 @@
+def extract_json(text):
+    start = text.find("{")
+    if start == -1:
+        return None
+
+    stack = 0
+
+    for i in range(start, len(text)):
+        if text[i] == "{":
+            stack += 1
+        elif text[i] == "}":
+            stack -= 1
+
+        if stack == 0:
+            return text[start:i + 1]
+
+    return None

saavnapi-2026.4.11/JioSaavn/Core/Request.py

@@ -0,0 +1,33 @@
+import aiohttp
+import json
+from .Parser import extract_json
+
+HEADERS = {
+    "User-Agent": "Mozilla/5.0"
+}
+
+
+class Request:
+    def __init__(self):
+        self.session = None
+
+    async def __aenter__(self):
+        self.session = aiohttp.ClientSession(headers=HEADERS)
+        return self
+
+    async def __aexit__(self, *args):
+        await self.session.close()
+
+    async def get(self, url):
+        try:
+            async with self.session.get(url, timeout=10) as res:
+                text = await res.text()
+                raw = extract_json(text)
+
+                if not raw:
+                    return None
+
+                return json.loads(raw)
+
+        except Exception:
+            return None

saavnapi-2026.4.11/JioSaavn/Formatter/Album.py

@@ -0,0 +1,19 @@
+from ..Utils.Text import clean
+from .Song import format_song
+
+
+async def format_album(data, lyrics_func=None):
+    data["image"] = data.get("image", "").replace("150x150", "500x500")
+    data["name"] = clean(data.get("name"))
+    data["primary_artists"] = clean(data.get("primary_artists"))
+    data["title"] = clean(data.get("title"))
+
+    songs = data.get("songs", [])
+
+    formatted = []
+    for s in songs:
+        formatted.append(await format_song(s, lyrics_func))
+
+    data["songs"] = formatted
+
+    return data

saavnapi-2026.4.11/JioSaavn/Formatter/Playlist.py

@@ -0,0 +1,17 @@
+from ..Utils.Text import clean
+from .Song import format_song
+
+
+async def format_playlist(data, lyrics_func=None):
+    data["firstname"] = clean(data.get("firstname"))
+    data["listname"] = clean(data.get("listname"))
+
+    songs = data.get("songs", [])
+
+    formatted = []
+    for s in songs:
+        formatted.append(await format_song(s, lyrics_func))
+
+    data["songs"] = formatted
+
+    return data

saavnapi-2026.4.11/JioSaavn/Formatter/Song.py

@@ -0,0 +1,60 @@
+from ..Utils.Crypto import decrypt
+from ..Utils.Text import clean
+
+
+async def format_song(data, lyrics_func=None):
+    more = data.get("more_info", {})
+
+    data["id"] = data.get("id")
+
+
+    data["song"] = clean(data.get("title"))
+
+
+    data["album"] = clean(more.get("album"))
+    data["music"] = clean(more.get("music"))
+
+
+    artists = more.get("artistMap", {}).get("primary_artists", [])
+    data["primary_artists"] = ", ".join([a.get("name", "") for a in artists])
+
+    
+    if data.get("image"):
+        data["image"] = data["image"].replace("150x150", "500x500")
+
+
+    duration = data.get("duration")
+    if duration:
+        try:
+            duration = int(duration)
+            mins = duration // 60
+            secs = duration % 60
+            data["duration"] = f"{mins}:{secs:02d}"
+        except:
+            data["duration"] = None
+    else:
+        data["duration"] = None
+
+
+    views = more.get("play_count") or more.get("view_count")
+    data["views"] = views
+
+
+    enc = more.get("encrypted_media_url")
+    if enc:
+        media = decrypt(enc)
+
+        if media and more.get("320kbps") != "true":
+            media = media.replace("_320.mp4", "_160.mp4")
+
+        data["media_url"] = media
+    else:
+        data["media_url"] = None
+
+    
+    if lyrics_func and more.get("has_lyrics") == "true":
+        data["lyrics"] = await lyrics_func(data.get("id"))
+    else:
+        data["lyrics"] = None
+
+    return data

saavnapi-2026.4.11/JioSaavn/Modules/Album.py

@@ -0,0 +1,19 @@
+from ..Core.Request import Request
+from .. import endpoints
+from ..Formatter.Album import format_album
+from .Lyrics import get_lyrics
+
+
+async def get_album(album_id, client=None):
+    url = endpoints.ALBUM + album_id
+
+    if client:
+        data = await client.get(url)
+    else:
+        async with Request() as req:
+            data = await req.get(url)
+
+    if not data:
+        return None
+
+    return await format_album(data, get_lyrics)

saavnapi-2026.4.11/JioSaavn/Modules/Lyrics.py

@@ -0,0 +1,17 @@
+from ..Core.Request import Request
+from .. import endpoints
+
+
+async def get_lyrics(song_id, client=None):
+    url = endpoints.LYRICS + song_id
+
+    if client:
+        data = await client.get(url)
+    else:
+        async with Request() as req:
+            data = await req.get(url)
+
+    if not data:
+        return None
+
+    return data.get("lyrics")

saavnapi-2026.4.11/JioSaavn/Modules/Playlist.py

@@ -0,0 +1,19 @@
+from ..Core.Request import Request
+from .. import endpoints
+from ..Formatter.Playlist import format_playlist
+from .Lyrics import get_lyrics
+
+
+async def get_playlist(list_id, client=None):
+    url = endpoints.PLAYLIST + list_id
+
+    if client:
+        data = await client.get(url)
+    else:
+        async with Request() as req:
+            data = await req.get(url)
+
+    if not data:
+        return None
+
+    return await format_playlist(data, get_lyrics)

saavnapi-2026.4.11/JioSaavn/Modules/Search.py

@@ -0,0 +1,46 @@
+import urllib.parse
+import asyncio
+
+from ..Core.Request import Request
+from .. import endpoints
+from ..Formatter.Song import format_song
+from .Lyrics import get_lyrics
+
+
+async def search(query, limit=10, lyrics=False, client=None):
+    query = urllib.parse.quote(query)
+    url = endpoints.SEARCH + query
+
+    if client:
+        data = await client.get(url)
+    else:
+        async with Request() as req:
+            data = await req.get(url)
+
+    if not data:
+        return []
+
+    songs = data.get("results") or data.get("songs", {}).get("data", [])
+    songs = songs[:limit]
+
+    sem = asyncio.Semaphore(5)
+
+    async def process(song):
+        try:
+            async with sem:
+                if not song.get("id"):
+                    return None
+
+                return await format_song(
+                    song,
+                    get_lyrics if lyrics else None
+                )
+        except:
+            return None
+
+    results = await asyncio.gather(*[
+        process(s) for s in songs
+    ], return_exceptions=True)
+
+
+    return [r for r in results if r and not isinstance(r, Exception)]

saavnapi-2026.4.11/JioSaavn/Modules/Song.py

@@ -0,0 +1,18 @@
+from ..Core.Request import Request
+from .. import endpoints
+from ..Formatter.Song import format_song
+from .Lyrics import get_lyrics
+
+
+async def get_song(song_id):
+    async with Request() as req:
+        data = await req.get(endpoints.SONG + song_id)
+
+    if not data:
+        return None
+
+    song = data.get(song_id)
+    if not song:
+        return None
+
+    return await format_song(song, get_lyrics)

saavnapi-2026.4.11/JioSaavn/Utils/Crypto.py

@@ -0,0 +1,21 @@
+import base64
+from pyDes import des, ECB, PAD_PKCS5
+#
+
+def decrypt(url):
+    try:
+        cipher = des(
+            b"38346591",
+            ECB,
+            b"\0\0\0\0\0\0\0\0",
+            pad=None,
+            padmode=PAD_PKCS5
+        )
+
+        decoded = base64.b64decode(url.strip())
+        decrypted = cipher.decrypt(decoded, padmode=PAD_PKCS5).decode("utf-8")
+
+        return decrypted.replace("_96.mp4", "_320.mp4")
+
+    except Exception:
+        return None

saavnapi-2026.4.11/JioSaavn/Utils/Text.py

@@ -0,0 +1,8 @@
+def clean(text):
+    if not text:
+        return ""
+    return (
+        text.replace(""", "'")
+        .replace("&", "&")
+        .replace("'", "'")
+    )

saavnapi-2026.4.11/JioSaavn/__init__.py

@@ -0,0 +1,13 @@
+from .Modules.Search import search
+from .Modules.Song import get_song
+from .Modules.Album import get_album
+from .Modules.Playlist import get_playlist
+from .Modules.Lyrics import get_lyrics
+
+__all__ = [
+    "search",
+    "get_song",
+    "get_album",
+    "get_playlist",
+    "get_lyrics"
+]

saavnapi-2026.4.11/JioSaavn/endpoints.py

@@ -0,0 +1,9 @@
+BASE_URL = "https://www.jiosaavn.com/api.php"
+
+COMMON = "&_format=json&_marker=0&api_version=4&cc=in"
+
+SEARCH = BASE_URL + "?__call=search.getResults" + COMMON + "&q="
+SONG = BASE_URL + "?__call=song.getDetails" + COMMON + "&pids="
+ALBUM = BASE_URL + "?__call=content.getAlbumDetails" + COMMON + "&albumid="
+PLAYLIST = BASE_URL + "?__call=playlist.getDetails" + COMMON + "&listid="
+LYRICS = BASE_URL + "?__call=lyrics.getLyrics" + COMMON + "&lyrics_id="

saavnapi-2026.4.11/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: SaavnAPI
+Version: 2026.4.11
+Summary: Fast async JioSaavn API wrapper for Python
+Author: ABHISHEK THAKUR
+License: MIT
+Keywords: jiosaavn,music,api,async,python,songs,lyrics,streaming
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: AsyncIO
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: pyDes>=2.0.1

saavnapi-2026.4.11/SaavnAPI.egg-info/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: SaavnAPI
+Version: 2026.4.11
+Summary: Fast async JioSaavn API wrapper for Python
+Author: ABHISHEK THAKUR
+License: MIT
+Keywords: jiosaavn,music,api,async,python,songs,lyrics,streaming
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: AsyncIO
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: pyDes>=2.0.1

saavnapi-2026.4.11/SaavnAPI.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+pyproject.toml
+JioSaavn/__init__.py
+JioSaavn/endpoints.py
+JioSaavn/Core/Client.py
+JioSaavn/Core/Parser.py
+JioSaavn/Core/Request.py
+JioSaavn/Formatter/Album.py
+JioSaavn/Formatter/Playlist.py
+JioSaavn/Formatter/Song.py
+JioSaavn/Modules/Album.py
+JioSaavn/Modules/Lyrics.py
+JioSaavn/Modules/Playlist.py
+JioSaavn/Modules/Search.py
+JioSaavn/Modules/Song.py
+JioSaavn/Utils/Crypto.py
+JioSaavn/Utils/Text.py
+SaavnAPI.egg-info/PKG-INFO
+SaavnAPI.egg-info/SOURCES.txt
+SaavnAPI.egg-info/dependency_links.txt
+SaavnAPI.egg-info/requires.txt
+SaavnAPI.egg-info/top_level.txt

saavnapi-2026.4.11/SaavnAPI.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

saavnapi-2026.4.11/SaavnAPI.egg-info/requires.txt

@@ -0,0 +1,2 @@
+aiohttp>=3.9.0
+pyDes>=2.0.1

saavnapi-2026.4.11/SaavnAPI.egg-info/top_level.txt

@@ -0,0 +1 @@
+JioSaavn

saavnapi-2026.4.11/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "SaavnAPI"
+version = "2026.4.11"
+description = "Fast async JioSaavn API wrapper for Python"
+readme = "README.md"
+requires-python = ">=3.8"
+
+authors = [
+  { name = "ABHISHEK THAKUR" }
+]
+
+license = { text = "MIT" }
+
+keywords = [
+  "jiosaavn",
+  "music",
+  "api",
+  "async",
+  "python",
+  "songs",
+  "lyrics",
+  "streaming"
+]
+
+dependencies = [
+  "aiohttp>=3.9.0",
+  "pyDes>=2.0.1"
+]
+
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Framework :: AsyncIO",
+  "Topic :: Multimedia :: Sound/Audio"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["JioSaavn*"]

saavnapi-2026.4.11/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+