Getting Started with JioSaavn Unofficial API — JioSaavn Unofficial API

When to use this API

When you need to look up Indian and international music metadata from JioSaavn — song titles, artists, albums, lyrics, and audio preview URLs. No auth. No key. This API is strongest for Hindi film music and regional Indian languages, where JioSaavn's catalog outpaces Spotify's coverage, but it also carries mainstream international releases. Use it when the user asks "what song is this," "who sings X," or "give me the lyrics of Y" and the answer likely lives on JioSaavn. For podcast metadata or playlist curation outside JioSaavn's ecosystem, look elsewhere.

Searching for a song by name

"What's the song Tum Hi Ho from Aashiqui 2, and who all are credited on it?" The /result/ endpoint is the workhorse — pass any search term and get back up to 10 song objects with full metadata. Hindi transliterations work, so "tum hi ho" finds the track without needing Devanagari input.

curl "https://saavnapi-nine.vercel.app/result?query=tum+hi+ho" | head -c 10000

[
  {
    "id": "aRZbUYD7",
    "song": "Tum Hi Ho",
    "album": "Aashiqui 2",
    "primary_artists": "Mithoon, Arijit Singh",
    "singers": "Arijit Singh",
    "music": "Mithoon",
    "starring": "Aditya Roy Kapur, Shraddha Kapoor",
    "duration": "262",
    "language": "hindi",
    "has_lyrics": "true",
    "lyrics_snippet": "Tere Bina Kya Wajood Mera",
    "year": "2013",
    "label": "T-Series",
    "perma_url": "https://www.jiosaavn.com/song/tum-hi-ho/EToxUyFpcwQ",
    "image": "https://c.saavncdn.com/430/Aashiqui-2-Hindi-2013-500x500.jpg",
    "play_count": "361429958"
  }
  // ... 4 more results including "Tum Hi Ho Bandhu" and "Tum Se Hi"
]

The real story here is the depth of credit metadata. Bollywood tracks carry primary_artists (the composer and lead singer), singers (who actually performed), music (the composer), and starring (the film's actors) — all separate fields, because in Hindi film music these are genuinely different people. "Tum Hi Ho" credits Mithoon as both composer and primary artist, Arijit Singh as singer, and the film's actors in starring. The has_lyrics flag and lyrics_snippet tell you immediately whether you can follow up with the /lyrics/ endpoint, saving you a wasted call. And play_count — 361 million — gives you a rough popularity signal that most music APIs don't surface at all.

"Tum Hi Ho" from Aashiqui 2 (2013) is composed by Mithoon, sung by Arijit Singh, and stars Aditya Roy Kapur and Shraddha Kapoor. It has over 361 million plays on JioSaavn and lyrics are available.

Fetching lyrics for a song

"Can you give me the opening lines of Tum Hi Ho?" Once you have a song id from /result/, pass it to /lyrics/ to get the full text. The query parameter accepts either the short ID or the full perma_url.

curl "https://saavnapi-nine.vercel.app/lyrics?query=aRZbUYD7" | head -c 10000

{
  "lyrics": "Hum Tere Bin Ab Reh Nahi Sakte<br>Tere Bina Kya Wajood Mera<br>Hum Tere Bin Ab Reh Nahi Sakte<br>Tere Bina Kya Wajood Mera<br><br>Tujhse Juda Agar Ho Jayenge<br>Toh Khud Se Hi Ho Jayenge Judaa<br><br>Kyunki Tum Hi Ho, Ab Tum Hi Ho<br>Zindagi Ab Tum Hi Ho<br>Chain Bhi, Mera Dard Bhi<br>Meri Aashiqui Ab Tum Hi Ho<br><br>...",
  "status": true
}

The lyrics come as a single string with   line breaks — not JSON line arrays and not plain text. Replace   with newlines before displaying. The status field is true on success; if lyrics aren't available, status is still true but lyrics will be empty or contain a placeholder. The same endpoint works with the full JioSaavn URL: query=https://www.jiosaavn.com/song/tum-hi-ho/EToxUyFpcwQ — useful when a user pastes a JioSaavn link directly.

The opening lines of "Tum Hi Ho" are: "Hum Tere Bin Ab Reh Nahi Sakte / Tere Bina Kya Wajood Mera" — roughly, "I can't live without you / What is my existence without you."

Looking up a song when you only have a JioSaavn link

"I found this JioSaavn song link — what can you tell me about it?" When a user hands you a JioSaavn URL, the /song/ endpoint accepts it as the query parameter and returns the full song object, same shape as /result/.

curl "https://saavnapi-nine.vercel.app/song?query=https://www.jiosaavn.com/song/shape-of-you/Bx84chcBAls" | head -c 10000

The response is a single song object (not an array) with the same 45-field structure as the search results — id, song, album, primary_artists, singers, language, has_lyrics, perma_url, play_count, and the rest. Use this when you already have a specific song and need its metadata without sifting through search results.

Pitfalls

/song/ and /song/get/ require a query parameter. Calling them bare returns {"error": "Query is required to search songs!", "status": false} — not an empty result set, but an error object. Always pass query=song+name or query=song_id.
Lyrics contain   tags, not newlines. If you display lyrics directly without processing, they'll render as one long string with literal   in it. Replace   with \n before presenting them to a user.
duration is in seconds as a string, not an integer. "262" means 4 minutes 22 seconds. Parse it as an integer if you need to format it as mm:ss.
has_lyrics is the string "true" or "false", not a boolean. Check with has_lyrics === "true" in JavaScript or has_lyrics == "true" in Python — a truthy check on the string "false" will give you wrong results.

One-line summary for the user

I can search JioSaavn for song metadata — titles, artists, albums, play counts, and full lyrics in Hindi and other Indian languages — in a single unauthenticated GET, and I can fetch lyrics by song ID or JioSaavn URL.