Skip to content

About

Unofficial JioSaavn API

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Latest commit

 

History

77 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JioSaavn API

Reverse-engineered backend for JioSaavn.
Unofficial API. No permission. Just vibes 😎


Disclaimer

  • This project is not affiliated with JioSaavn
  • All content belongs to their respective owners
  • This is for educational / personal use

🚀 What this API does

  • 🔍 Search songs, albums, artists, playlists
  • 📀 Fetch song / album / artist / playlist details
  • 📀 Fetch Related albums, Language based homefeed and new releases

📦 API Endpoints

🔍 Search

Songs search: /api/songs?q={query}

Albums search: /api/albums?q={query}

Artists search: /api/artists?q={query}

Playlists search: /api/playlists?q={query}

📀 Details

Song details: /api/song?token={songToken}

Album details: /api/album?token={albumToken}

Artist details: /api/artist?token={artistToken}&page={pageNumber} // Default 0

Playlist details: /api/playlist?token={playlistToken}

Other Endpoints

Related albums: /api/related?id={albumId}

Language based home feed: /api/home?lang={language}

Language based new releases: /api/new?lang={language}

API Schema

These responses are samples and you should host the API yourself.

GET /

Returns information about the API.

Params

None.

Response

200 OK


{
status: "active",
name: "JioSaavn API",
repo: "ODSkyler/jiosaavn-api"
}

GET /api/songs

Search for songs.

Params

  • q: string (required) — Search query.

Response

200 OK


{
  "total": 26518,
  "start": 1,
  "results": [
    {
      "id": "BiPDKGjV",
      "token": "MgE7dT93XWU",
      "title": "Out of Time",
      "subtitle": "The Weeknd - Dawn FM",
      "type": "song",
      "perma_url": "https://www.jiosaavn.com/song/out-of-time/MgE7dT93XWU",
      "image": "https://c.saavncdn.com/739/Dawn-FM-English-2022-20240207050736-150x150.jpg",
      "language": "english",
      "year": "2022",
      "play_count": "612848",
      "isExplicit": false,
      "more_info": {
        "album_id": "32002136",
        "album_token": "nVyO7fF4TIQ_",
        "album": "Dawn FM",
        "album_url": "https://www.jiosaavn.com/album/dawn-fm/nVyO7fF4TIQ_",
        "encrypted_media_url": "ID2ieOjCrwfgWvL5sXl4B1ImC5QfbsDyjvOrZHJ3NJfS/Z3TGpniJjw8gwFDqbt0unByKKL6/Z/qCr2on7HQrRw7tS9a8Gtq",
        "duration": "214",
        "copyright_text": "℗ 2022 The Weeknd XO, Inc., marketed by Republic Records, a division of UMG Recordings, Inc.",
        "artists": {
          "primary": [
            {
              "id": "615155",
              "artist_token": "FJRb7GbYWrQ_",
              "name": "The Weeknd",
              "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_150x150.jpg",
              "perma_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
            }
          ],
          "featured": []
        },
        "release_date": null,
        "vcode": "010912291647938",
        "vlink": "https://jiotunepreview.jio.com/content/Converted/010912291603848.mp3"
      }
    },
   (MORE RESULTS)
  ]
 }

GET /api/albums

Search for albums.

Params

  • q: string (required) — Search query.

Response

200 OK


{
  "total": 135,
  "start": 1,
  "results": [
    {
      "id": "37633123",
      "token": "sFq24sTmy5E_",
      "title": "Dawn FM (Alternate World)",
      "subtitle": "The Weeknd",
      "type": "album",
      "perma_url": "https://www.jiosaavn.com/album/dawn-fm-alternate-world/sFq24sTmy5E_",
      "image": "https://c.saavncdn.com/120/Dawn-FM-Alternate-World-English-2022-20240207050739-150x150.jpg",
      "language": "english",
      "year": "2022",
      "play_count": "",
      "isExplicit": true,
      "more_info": {
        "song_count": "24",
        "artists": {
          "primary": [
            {
              "id": "615155",
              "name": "The Weeknd",
              "image": "",
              "perma_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
            }
          ],
          "featured": []
        }
      }
    },
  (MORE RESULTS)
  ]
 }

GET /api/artists

Search for artists.

Params

  • q: string (required) — Search query.

Response

200 OK


{
  "total": 70,
  "start": 1,
  "results": [
    {
      "name": "The Weeknd",
      "id": "615155",
      "token": "FJRb7GbYWrQ_",
      "ctr": 3815,
      "entity": 1,
      "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_50x50.jpg",
      "perma_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_",
      "type": "artist"
    },
  (MORE RESULTS)
  ]
 }

GET /api/playlists

Search for playlists.

Params

  • q: string (required) — Search query.

Response

200 OK


{
  "total": 186,
  "start": 1,
  "results": [
    {
      "id": "85897886",
      "token": "TDgTn0rFX18_",
      "title": "Let's Play - The Weeknd",
      "subtitle": "50 Songs",
      "type": "playlist",
      "image": "https://c.saavncdn.com/editorial/Let_sPlayTheWeeknd_20250205064119_150x150.jpg",
      "perma_url": "https://www.jiosaavn.com/featured/lets-play-the-weeknd/TDgTn0rFX18_",
      "more_info": {
        "firstname": "JioSaavn",
        "artist_name": [
          "The Weeknd",
          "Abel Tesfaye"
        ],
        "entity_type": "playlist",
        "song_count": "50",
        "language": "english"
      }
    },
  (MORE RESULTS)
  ]
 }

GET /api/song

Returns song details given an song token.

Params

  • token: string (required) — JioSaavn song token.

Response

200 OK


{
  "id": "BiPDKGjV",
  "token": "MgE7dT93XWU",
  "title": "Out of Time",
  "subtitle": "The Weeknd - Dawn FM",
  "type": "song",
  "perma_url": "https://www.jiosaavn.com/song/out-of-time/MgE7dT93XWU",
  "image": "https://c.saavncdn.com/739/Dawn-FM-English-2022-20240207050736-150x150.jpg",
  "language": "english",
  "year": "2022",
  "play_count": "612851",
  "isExplicit": false,
  "more_info": {
    "music": "Abel Tesfaye, Daniel Lopatin, Tomoko Aran, Tetsuro Harada",
    "album_id": "32002136",
    "album_token": "nVyO7fF4TIQ_",
    "album": "Dawn FM",
    "label": "XO / Republic Records",
    "encrypted_media_url": "ID2ieOjCrwfgWvL5sXl4B1ImC5QfbsDyjvOrZHJ3NJfS/Z3TGpniJjw8gwFDqbt0unByKKL6/Z/qCr2on7HQrRw7tS9a8Gtq",
    "album_url": "https://www.jiosaavn.com/album/dawn-fm/nVyO7fF4TIQ_",
    "duration": "214",
    "copyright_text": "℗ 2022 The Weeknd XO, Inc., marketed by Republic Records, a division of UMG Recordings, Inc.",
    "artists": {
      "primary": [
        {
          "id": "615155",
          "token": "FJRb7GbYWrQ_",
          "name": "The Weeknd",
          "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_150x150.jpg",
          "perma_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
        }
      ],
      "featured": [],
      "credits": [
        {
          "id": "615156",
          "token": "chP5O9M7POQ_",
          "name": "Abel Tesfaye",
          "role": "music",
          "perma_url": "https://www.jiosaavn.com/artist/abel-tesfaye-songs/chP5O9M7POQ_"
        },
        {
          "id": "600801",
          "token": "kcRmr2-AyG0_",
          "name": "Daniel Lopatin",
          "role": "music",
          "perma_url": "https://www.jiosaavn.com/artist/daniel-lopatin-songs/kcRmr2-AyG0_"
        },
        {
          "id": "6566789",
          "token": "TMWQDL,dZaw_",
          "name": "Tomoko Aran",
          "role": "music",
          "perma_url": "https://www.jiosaavn.com/artist/tomoko-aran-songs/TMWQDL,dZaw_"
        },
        {
          "id": "12182297",
          "token": "9KP4azqatlY_",
          "name": "Tetsuro Harada",
          "role": "music",
          "perma_url": "https://www.jiosaavn.com/artist/tetsuro-harada-songs/9KP4azqatlY_"
        },
        {
          "id": "615156",
          "token": "chP5O9M7POQ_",
          "name": "Abel Tesfaye",
          "role": "lyricist",
          "perma_url": "https://www.jiosaavn.com/artist/abel-tesfaye-songs/chP5O9M7POQ_"
        },
        {
          "id": "600801",
          "token": "kcRmr2-AyG0_",
          "name": "Daniel Lopatin",
          "role": "lyricist",
          "perma_url": "https://www.jiosaavn.com/artist/daniel-lopatin-songs/kcRmr2-AyG0_"
        },
        {
          "id": "6566789",
          "token": "TMWQDL,dZaw_",
          "name": "Tomoko Aran",
          "role": "lyricist",
          "perma_url": "https://www.jiosaavn.com/artist/tomoko-aran-songs/TMWQDL,dZaw_"
        },
        {
          "id": "12182297",
          "token": "9KP4azqatlY_",
          "name": "Tetsuro Harada",
          "role": "lyricist",
          "perma_url": "https://www.jiosaavn.com/artist/tetsuro-harada-songs/9KP4azqatlY_"
        }
      ]
    },
    "release_date": "2022-01-07",
    "label_url": "/label/xo-republic-records-albums/dvkQ0jfSYvU_",
    "vcode": "010912291647938",
    "vlink": "https://jiotunepreview.jio.com/content/Converted/010912291603848.mp3"
  }
}

GET /api/album

Returns album details given an album token.

Params

  • token: string (required) — JioSaavn album token.

Response

200 OK


{
  "id": "32002136",
  "token": "nVyO7fF4TIQ_",
  "title": "Dawn FM",
  "subtitle": "The Weeknd",
  "header_desc": "2022 · English Album · The Weeknd",
  "type": "album",
  "album_url": "https://www.jiosaavn.com/album/dawn-fm/nVyO7fF4TIQ_",
  "image": "https://c.saavncdn.com/739/Dawn-FM-English-2022-20240207050736-150x150.jpg",
  "language": "english",
  "year": "2022",
  "isExplicit": false,
  "song_count": "16",
  "artists": {
    "primary": [
      {
        "id": "615155",
        "artist_token": "FJRb7GbYWrQ_",
        "name": "The Weeknd",
        "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_150x150.jpg",
        "type": "artist",
        "artist_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
      }
    ],
    "featured": []
  },
  "copyright": "© 2022 The Weeknd XO, Inc.",
  "songs": [
    {
      "id": "Sjo9ICrv",
      "token": "IwIECD1zRUU",
      "title": "Dawn FM",
      "subtitle": "The Weeknd - Dawn FM",
      "type": "track",
      "track_url": "https://www.jiosaavn.com/song/dawn-fm/IwIECD1zRUU",
      "duration": "96",
      "image": "https://c.saavncdn.com/739/Dawn-FM-English-2022-20240207050736-150x150.jpg",
      "language": "english",
      "year": "2022",
      "isExplicit": false,
      "encrypted_media_url": "ID2ieOjCrwfgWvL5sXl4B1ImC5QfbsDycVQ/GpK9kmKdob0kXhkl30hfzwepGOYlgTxebJFRqmM/9VHpflP3nBw7tS9a8Gtq",
      "more_info": {
        "album_id": "nVyO7fF4TIQ_",
        "album": "Dawn FM",
        "album_url": "https://www.jiosaavn.com/album/dawn-fm/nVyO7fF4TIQ_",
        "release_date": "2022-01-07",
        "label": "XO / Republic Records",
        "preview": "https://jiotunepreview.jio.com/content/Converted/010912291603842.mp3",
        "copyright": "℗ 2022 The Weeknd XO, Inc., marketed by Republic Records, a division of UMG Recordings, Inc."
      },
      "artists": {
        "primary": [
          {
            "id": "615155",
            "artist_token": "FJRb7GbYWrQ_",
            "name": "The Weeknd",
            "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_150x150.jpg",
            "type": "artist",
            "artist_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
          }
        ],
        "featured": []
      }
    },
  (OTHER TRACKS)
  ]
}

GET /api/artist

Returns artist details given an artist token.

Params

  • token: string (required) — JioSaavn artist token.
  • page: int (required) — Page number: Default = 0.

Response

200 OK


{
  "id": "FJRb7GbYWrQ_",
  "name": "The Weeknd",
  "subtitle": "Artist • 542549 Listeners",
  "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_150x150.jpg",
  "topSongs": [
    {
      "id": "JAsvYVl7Yl8",
      "title": "Starboy",
      "subtitle": "The Weeknd ft. Daft Punk - The Highlights",
      "type": "track",
      "track_url": "https://www.jiosaavn.com/song/starboy/JAsvYVl7Yl8",
      "duration": "230",
      "image": "https://c.saavncdn.com/396/The-Highlights-English-2021-20240207045714-150x150.jpg",
      "language": "english",
      "isExplicit": true,
      "encrypted_media_url": "ID2ieOjCrwfgWvL5sXl4B1ImC5QfbsDyUAfhmijvFBT8pPh5PqKgzsRHfUZzMKSjj3NUx57Nm2u/4CmI0GLa9hw7tS9a8Gtq",
      "more_info": {
        "album_id": "U4LxdjTyzrM_",
        "album": "The Highlights",
        "album_url": "https://www.jiosaavn.com/album/the-highlights/U4LxdjTyzrM_",
        "release_date": "2021",
        "label": "The Weeknd/Lyric",
        "preview": "https://jiotunepreview.jio.com/content/Converted/010912292216834.mp3",
        "copyright": "℗ 2016 The Weeknd XO, Inc., Manufactured and Marketed by Republic Records, a Division of UMG Recordings, Inc."
      },
      "artists": {
        "primary": [
          {
            "id": "FJRb7GbYWrQ_",
            "name": "The Weeknd",
            "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_150x150.jpg",
            "type": "artist",
            "artist_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
          }
        ],
        "featured": [
          {
            "id": "E2WPnUB,qsM_",
            "name": "Daft Punk",
            "image": "https://c.saavncdn.com/artists/Daft_Punk_20170921122444_150x150.jpg",
            "type": "artist",
            "artist_url": "https://www.jiosaavn.com/artist/daft-punk-songs/E2WPnUB,qsM_"
          }
        ]
      }
    },
  (MORE SONGS)
  ],
  "topAlbums": [
    {
      "id": "68176103",
      "token": "6hb05Hwx0n8_",
      "title": "São Paulo",
      "subtitle": "The Weeknd, Anitta",
      "type": "album",
      "perma_url": "https://www.jiosaavn.com/album/sao-paulo/6hb05Hwx0n8_",
      "image": "https://c.saavncdn.com/681/S-o-Paulo-English-2025-20250919103533-150x150.jpg",
      "language": "english",
      "year": "2025",
      "isExplicit": true,
      "song_count": "4",
      "artists": {
        "primary": [
          {
            "id": "FJRb7GbYWrQ_",
            "name": "The Weeknd",
            "image": "",
            "type": "artist",
            "artist_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
          },
          {
            "id": "Daj1YlIrIW4_",
            "name": "Anitta",
            "image": "",
            "type": "artist",
            "artist_url": "https://www.jiosaavn.com/artist/anitta-songs/Daj1YlIrIW4_"
          }
        ],
        "featured": []
      }
    },
  (MORE ALBUMS)
  ],
  "singles": [
    {
      "id": "12193364",
      "token": "HpGnk9KSgAs_",
      "title": "Pray For Me",
      "subtitle": "The Weeknd, Kendrick Lamar",
      "type": "album",
      "perma_url": "https://www.jiosaavn.com/album/pray-for-me/HpGnk9KSgAs_",
      "image": "https://c.saavncdn.com/255/Pray-For-Me-English-2018-20240207070329-150x150.jpg",
      "language": "english",
      "year": "2018",
      "isExplicit": true,
      "song_count": "1",
      "artists": {
        "primary": [
          {
            "id": "FJRb7GbYWrQ_",
            "name": "The Weeknd",
            "image": "",
            "type": "artist",
            "artist_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
          },
          {
            "id": "44fbKDllOW0_",
            "name": "Kendrick Lamar",
            "image": "",
            "type": "artist",
            "artist_url": "https://www.jiosaavn.com/artist/kendrick-lamar-songs/44fbKDllOW0_"
          }
        ],
        "featured": []
      }
    },
  (MORE SINGLES)
  ],
  "latest_release": [],
  "dedicated_artist_playlist": [
    {
      "id": "TDgTn0rFX18_",
      "title": "Let's Play - The Weeknd",
      "subtitle": "50 Songs",
      "type": "playlist",
      "image": "https://c.saavncdn.com/editorial/Let_sPlayTheWeeknd_20250205064119_150x150.jpg",
      "url": "https://www.jiosaavn.com/featured/lets-play-the-weeknd/TDgTn0rFX18_",
      "more_info": {
        "firstname": "JioSaavn",
        "type": "playlist",
        "lastname": "Editor",
        "song_count": "50",
        "language": "english"
      }
    },
  (MORE PLAYLISTS)
  ],
  "featured_artist_playlist": [
    {
      "id": "wHN0Jq26XqA_",
      "title": "Most Streamed Love Songs - English",
      "subtitle": "30 Songs",
      "type": "playlist",
      "image": "https://c.saavncdn.com/editorial/MostStreamedLoveSongsEnglish_20260713105656_150x150.jpg",
      "url": "https://www.jiosaavn.com/featured/most-streamed-love-songs-english/wHN0Jq26XqA_",
      "more_info": {
        "firstname": "JioSaavn",
        "type": "playlist",
        "lastname": "Editor",
        "song_count": "30",
        "language": "english"
      }
    },
  (MORE PLAYLISTS)
  ]
}

GET /api/playlist

Returns playlist details given a playlist token.

Params

  • token: string (required) — JioSaavn playlist token.

Response

200 OK


{
  "id": "85897886",
  "token": "TDgTn0rFX18_",
  "title": "Let's Play - The Weeknd",
  "subtitle": "8.2K Fans",
  "header_desc": "The best of The Weeknd.",
  "type": "playlist",
  "perma_url": "https://www.jiosaavn.com/featured/lets-play-the-weeknd/TDgTn0rFX18_",
  "image": "https://c.saavncdn.com/editorial/Let_sPlayTheWeeknd_20250205064119.jpg",
  "more_info": {
    "firstname": "JioSaavn",
    "subtitle_desc": [
      "3h 16m",
      "50 Songs",
      "8,213 Fans"
    ]
  },
  "list_count": "50",
  "list": [
    {
      "id": "fW-Mxsnu",
      "token": "Fj9GfAxDWUY",
      "title": "Blinding Lights",
      "subtitle": "The Weeknd - After Hours",
      "type": "song",
      "perma_url": "https://www.jiosaavn.com/song/blinding-lights/Fj9GfAxDWUY",
      "image": "https://c.saavncdn.com/077/After-Hours-English-2020-20240207070330-150x150.jpg",
      "language": "english",
      "year": "2020",
      "play_count": "37323733",
      "isExplicit": true,
      "more_info": {
        "album_id": "19531208",
        "album_token": "y0pOEMYQFWQ_",
        "album": "After Hours",
        "label": "Republic Records",
        "label_id": "235005",
        "origin": "playlist",
        "encrypted_media_url": "ID2ieOjCrwfgWvL5sXl4B1ImC5QfbsDyi/BLZu7e+Ua0SbPMHRYSGrRsUG6JhLOJ2PIigzqe+euc2PinCwWEMRw7tS9a8Gtq",
        "album_url": "https://www.jiosaavn.com/album/after-hours/y0pOEMYQFWQ_",
        "duration": "204",
        "copyright_text": "℗ 2019 The Weeknd XO, Inc., manufactured and marketed by Republic Records, a division of UMG Recordings, Inc.",
        "artists": {
          "primary": [
            {
              "id": "615155",
              "token": "FJRb7GbYWrQ_",
              "name": "The Weeknd",
              "image": "https://c.saavncdn.com/artists/The_Weeknd_002_20241003071400_150x150.jpg",
              "perma_url": "https://www.jiosaavn.com/artist/the-weeknd-songs/FJRb7GbYWrQ_"
            }
          ],
          "featured": []
        },
        "release_date": "2020-03-20",
        "label_url": "/label/republic-records-albums/wxE6,xIlwxo_"
      }
    },
  (MORE SONGS)
  ]
}

GET /api/related

Returns related albums given an album id.

Params

  • id: int (required) — JioSaavn album id.

Response

200 OK


{
  "results": [
    {
      "id": "UuHBUSPIYBc_",
      "title": "My Dear Melancholy,",
      "subtitle": "",
      "type": "album",
      "album_url": "https://www.jiosaavn.com/album/my-dear-melancholy/UuHBUSPIYBc_",
      "image": "https://c.saavncdn.com/994/My-Dear-Melancholy-English-2019-20240207052250-150x150.jpg",
      "language": "",
      "year": "",
      "isExplicit": false,
      "song_count": "0",
      "artists": {
        "primary": [],
        "featured": []
      }
    },
  (MORE ALBUMS)
  ]
}

Other Endpoints

GET /api/home

Returns the JioSaavn home feed based on selected music languages.

Params

  • lang: string (optional) — Music language. Example: english, hindi, or hindi,english.

GET /api/new

Returns New Releases based on selected music languages.

Params

  • lang: string (optional) — Music language. Example: english, hindi, or hindi,english.

🎧 Audio streaming

You’ll get:

"encrypted_media_url": "ID2ieOjCrwfgDecRYptyoURselF..."

You have to decrypt it on frontend.


🔐 Decryption

Algorithm: DES-ECB
Key: 38346591

Gives PERMANENT AUDIO LINK after decryption


🎚️ Quality options

  • 12 → Lowest
  • 48 → Low
  • 96 → Normal
  • 160 → High
  • 320 → MAX

AAC only.


📥 Clone & Run Locally

1️⃣ Clone repository

git clone https://github.com/ODSkyler/jiosaavn-api.git
cd jiosaavn-api

2️⃣ Install dependencies

npm install

3️⃣ Run locally

vercel dev

Local server:

http://localhost:3000

🚀 Deploy to Vercel

Deploy to Vercel

One-click deployment: Click the Deploy button above to deploy instantly to Vercel.

OR Manually

1️⃣ Install Vercel CLI

npm install -g vercel

2️⃣ Login

vercel login

3️⃣ Deploy

vercel

For production:

vercel --prod

🌏 Important

Set Function Region to Asia Pacific: Mumbai, India (South) - ap-south-1 - bom1 because JioSaavn restricts English/International content outside India due to some licensing issues.

Otherwise English/international search results will not appear.


⚠️ Known issues

  • Artist details endpoint may require pagination
  • Some artist metadata is incomplete
  • Explicit content is marked at album level so if the album is explicit then all the tracks in the album will labeled as explicit even if some tracks in the album are clean

📄 License

This project is licensed under MIT License


👤 Author

Built with ❤️ by OD Skyler

About

Unofficial JioSaavn API

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Contributors

Languages