JioSaavn API Documentation
Welcome to the JioSaavn Unofficial API documentation. This API provides access to JioSaavn's vast music library, including songs, albums, playlists, and more.
Base URL
http://localhost:3500
Rate Limiting
To ensure fair usage, the API implements rate limiting. Each IP address is limited to:
- 100 requests per minute
- 1000 requests per hour
If you exceed these limits, you'll receive a 429 Too Many Requests response.
Response Format
All API responses follow this standard format:
{
"status": "SUCCESS" | "FAILED",
"message": "Optional status message",
"data": { ... } // The actual response data
}
Authentication
This API is currently open and does not require authentication. However, please respect the rate limits and use the API responsibly.
Search API
GET
/search?q={query}
Search for songs, albums, artists, or playlists
Parameters
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query (required) |
| type | string | Filter results by type: all, songs, albums, artists, playlists (optional, defaults to all) |
| limit | number | Number of results to return (optional, defaults to 10, max 50) |
Response Example
{
"status": "SUCCESS",
"data": {
"songs": [
{
"id": "abc123",
"name": "Song Name",
"album": "Album Name",
"year": "2024",
"duration": "4:30",
"primaryArtists": "Artist Name",
"image": "https://...",
"downloadUrl": "https://..."
}
],
"albums": [...],
"artists": [...],
"playlists": [...]
}
}
GET
/search/songs?q={query}
Search for songs only
GET
/search/albums?q={query}
Search for albums only
Songs API
GET
/song?id={id}
Get details of a specific song
Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Song ID (required) |
Response Example
{
"status": "SUCCESS",
"data": {
"id": "abc123",
"name": "Song Name",
"album": {
"id": "album123",
"name": "Album Name",
"url": "https://..."
},
"year": "2024",
"duration": "4:30",
"language": "hindi",
"primaryArtists": [
{
"id": "artist123",
"name": "Artist Name",
"url": "https://..."
}
],
"featuredArtists": [],
"downloadUrl": {
"quality_96": "https://...",
"quality_160": "https://...",
"quality_320": "https://..."
},
"image": {
"quality_50x50": "https://...",
"quality_150x150": "https://...",
"quality_500x500": "https://..."
}
}
}
Albums API
GET
/album?id={id}
Get details of a specific album including all songs
Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Album ID (required) |
Response Example
{
"status": "SUCCESS",
"data": {
"id": "album123",
"name": "Album Name",
"year": "2024",
"primaryArtists": ["Artist 1", "Artist 2"],
"songCount": 12,
"image": {
"quality_50x50": "https://...",
"quality_150x150": "https://...",
"quality_500x500": "https://..."
},
"songs": [
{
"id": "song123",
"name": "Song Name",
"duration": "4:30",
"downloadUrl": {
"quality_96": "https://...",
"quality_160": "https://...",
"quality_320": "https://..."
}
}
]
}
}
Playlists API
GET
/playlist?id={id}
Get details of a specific playlist including all songs
Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Playlist ID (required) |
Response Example
{
"status": "SUCCESS",
"data": {
"id": "playlist123",
"name": "Playlist Name",
"description": "Playlist Description",
"songCount": 25,
"fanCount": 1000,
"image": "https://...",
"songs": [
{
"id": "song123",
"name": "Song Name",
"album": "Album Name",
"artists": ["Artist 1", "Artist 2"],
"duration": "4:30",
"downloadUrl": {
"quality_96": "https://...",
"quality_160": "https://...",
"quality_320": "https://..."
}
}
]
}
}
Artists API
GET
/artist?id={id}
Get artist details including top songs and albums
Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Artist ID (required) |
Response Example
{
"status": "SUCCESS",
"data": {
"id": "artist123",
"name": "Artist Name",
"image": "https://...",
"followerCount": 100000,
"bio": "Artist biography...",
"topSongs": [...],
"topAlbums": [...],
"featuredIn": [...]
}
}
Lyrics API
GET
/lyrics?id={id}
Get lyrics for a specific song
Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Song ID (required) |
Response Example
{
"status": "SUCCESS",
"data": {
"lyrics": "Song lyrics...",
"copyright": "Lyrics copyright...",
"snippet": "Short lyrics preview..."
}
}
Download API
GET
/download?id={id}&quality={quality}
Get download links for a song in different qualities
Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Song ID (required) |
| quality | string | Audio quality: 96, 160, 320 (optional, defaults to highest available) |
Response Example
{
"status": "SUCCESS",
"data": {
"id": "song123",
"name": "Song Name",
"album": "Album Name",
"year": "2024",
"downloadUrl": "https://...",
"quality": "320",
"size": "9.5 MB"
}
}
Radio API
GET
/radio/songs?id={station_id}
Get songs from a radio station
Parameters
| Parameter | Type | Description |
|---|---|---|
| station_id | string | Radio station ID (required) |
Trending
GET
/trending
Get trending songs, albums, and playlists
Parameters
| Parameter | Type | Description |
|---|---|---|
| type | string | Content type: all, songs, albums, playlists (optional, defaults to all) |
| lang | string | Language filter (optional) |