# JioSaavn — Zapi reference

> Search and fetch songs, albums, and playlists from JioSaavn with full audio download URLs at multiple bitrates.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/music/jiosaavn
- Endpoint catalog: https://zpi.web.id/category/music
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## JioSaavn

**Category:** music · **Slug:** `jiosaavn`
**Detail page:** https://zpi.web.id/api/music/jiosaavn

Search and fetch songs, albums, and playlists from JioSaavn with full audio download URLs at multiple bitrates.

**Tags:** music, search, download, stream

### Search

Search the catalog by text query.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/music:jiosaavn/search`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Search query (title, artist, etc) |
| `limit` | number | query | no | Items per page (1-40). Default: 20 |
| `page` | number | query | no | Page 1-based. Default: 1 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:jiosaavn/search?q=blinding%20lights&limit=20&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:jiosaavn/search?q=blinding%20lights&limit=20&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/music:jiosaavn/search?q=blinding%20lights&limit=20&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 85,
  "items": [
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights-techno/JQM9YzV6cnk",
      "type": "track",
      "album": "Blinding Lights",
      "image": "https://c.saavncdn.com/004/Blinding-Lights-Instrumental-2024-20250116131427-500x500.jpg",
      "label": "Glowave Town",
      "title": "Blinding Lights (Techno)",
      "artist": "Error404, Glowave Town",
      "albumId": "54994972",
      "artists": [
        {
          "id": "1029498",
          "url": "https://www.jiosaavn.com/artist/error404-songs/Qiv55cecT60_",
          "name": "Error404",
          "image": "https://c.saavncdn.com/707/Fuck-Me-I-m-Famous-English-2013-500x500.jpg"
        },
        {
          "id": "17043714",
          "url": "https://www.jiosaavn.com/artist/glowave-town-songs/OgI1-BeWNA0_",
          "name": "Glowave Town"
        }
      ],
      "trackId": "UkVRAJEJ",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/pDR8bo-PMDA_",
      "language": "instrumental",
      "copyright": "© 2024 the Weeknd",
      "hasLyrics": false,
      "playCount": 45,
      "durationMs": 154000,
      "isExplicit": false,
      "releaseYear": "2024"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/GRs0SAxYWWQ",
      "type": "track",
      "album": "Caletta Remixes",
      "image": "https://c.saavncdn.com/492/Caletta-Remixes-Instrumental-2025-20250605114214-500x500.jpg",
      "label": "The Vibes Network",
      "title": "Blinding Lights",
      "artist": "Nyae",
      "albumId": "65210356",
      "artists": [
        {
          "id": "10992508",
          "url": "https://www.jiosaavn.com/artist/nyae-songs/RKWQCMUVlf0_",
          "name": "Nyae"
        }
      ],
      "trackId": "is_yxhnW",
      "albumUrl": "https://www.jiosaavn.com/album/caletta-remixes/7rS2htRDXq8_",
      "language": "instrumental",
      "copyright": "© 2025 Outkast, R.E.M., Bruno Mars, Lady Gaga, Bob Marley, The Wailers, The Verve, The Weeknd, SNAP!, Snow Patrol",
      "hasLyrics": false,
      "playCount": 6,
      "durationMs": 174000,
      "isExplicit": false,
      "releaseYear": "2025"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/RDgiSDgDB1o",
      "type": "track",
      "album": "Blinding Lights",
      "image": "https://c.saavncdn.com/137/Blinding-Lights-Instrumental-2024-20241007104639-500x500.jpg",
      "label": "7clouds",
      "title": "Blinding Lights",
      "artist": "Glazey",
      "albumId": "58670997",
      "artists": [
        {
          "id": "20047250",
          "url": "https://www.jiosaavn.com/artist/glazey-songs/XhstKOxjMMM_",
          "name": "Glazey"
        }
      ],
      "trackId": "4PIyL30i",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/Y5rN2e4Vkw8_",
      "language": "instrumental",
      "copyright": "© 2024 the Weeknd",
      "hasLyrics": false,
      "playCount": 4,
      "durationMs": 141000,
      "isExplicit": false,
      "releaseYear": "2024"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/QyQGSEwDBkM",
      "type": "track",
      "album": "Soothing Guitar Covers, Vol. 2",
      "image": "https://c.saavncdn.com/586/Soothing-Guitar-Covers-Vol-2-Instrumental-2024-20240209163229-500x500.jpg",
      "label": "SoundTrak",
      "title": "Blinding Lights",
      "artist": "Guitar Cafetéria",
      "albumId": "51761586",
      "artists": [
        {
          "id": "18620370",
          "url": "https://www.jiosaavn.com/artist/guitar-cafeteria-songs/q14JpqDy8LM_",
          "name": "Guitar Cafetéria"
        }
      ],
      "trackId": "3Lmy831p",
      "albumUrl": "https://www.jiosaavn.com/album/soothing-guitar-covers-vol.-2/8zJsAkUBnS8_",
      "language": "instrumental",
      "copyright": "© 2024 Guitar Cafetéria Music",
      "hasLyrics": false,
      "playCount": 1,
      "durationMs": 271000,
      "isExplicit": false,
      "releaseYear": "2024"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/AwAtWDx0A0I",
      "type": "track",
      "album": "Blinding Lights",
      "image": "https://c.saavncdn.com/523/Blinding-Lights-Instrumental-2025-20251128141705-500x500.jpg",
      "label": "Sound Tower",
      "title": "Blinding Lights",
      "artist": "Sound Tower",
      "albumId": "70269145",
      "artists": [
        {
          "id": "20034459",
          "url": "https://www.jiosaavn.com/artist/sound-tower-songs/-2ljXsf1gCI_",
          "name": "Sound Tower"
        }
      ],
      "trackId": "shFiHD4q",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/Gd0BZAwAWnU_",
      "language": "instrumental",
      "copyright": "© 2025 The Weeknd",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 156000,
      "isExplicit": false,
      "releaseYear": "2025"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/QBonZi5mbVg",
      "type": "track",
      "album": "Blinding Lights",
      "image": "https://c.saavncdn.com/405/Blinding-Lights-Instrumental-2020-20240702091900-500x500.jpg",
      "label": "Magic Records",
      "title": "Blinding Lights",
      "artist": "Coopex, Eben, Tim Moyo",
      "albumId": "55766831",
      "artists": [
        {
          "id": "3993374",
          "url": "https://www.jiosaavn.com/artist/coopex-songs/eXQXK8gaGeI_",
          "name": "Coopex",
          "image": "https://c.saavncdn.com/910/On-the-Line-English-2019-20200105104401-500x500.jpg"
        },
        {
          "id": "856387",
          "url": "https://www.jiosaavn.com/artist/eben-songs/wvfTNjvRSG8_",
          "name": "Eben",
          "image": "https://c.saavncdn.com/185/Hades-English-2018-20180314174238-500x500.jpg"
        },
        {
          "id": "2515906",
          "url": "https://www.jiosaavn.com/artist/tim-moyo-songs/matjNT7rH40_",
          "name": "Tim Moyo",
          "image": "https://c.saavncdn.com/391/Stay-Here-Undone-English-2018-20181005211913-500x500.jpg"
        }
      ],
      "trackId": "0rLWZVZk",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/b9liO5c,NYM_",
      "language": "instrumental",
      "copyright": "© 2020 The Weeknd",
      "hasLyrics": false,
      "playCount": 95,
      "durationMs": 197000,
      "isExplicit": false,
      "releaseYear": "2020"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/NR8SeSJYBlg",
      "type": "track",
      "album": "Here",
      "image": "https://c.saavncdn.com/598/Here-Instrumental-2025-20250116105138-500x500.jpg",
      "label": "vom deich gechillt",
      "title": "Blinding Lights",
      "artist": "vom deich gechillt",
      "albumId": "61278208",
      "artists": [
        {
          "id": "17497585",
          "url": "https://www.jiosaavn.com/artist/vom-deich-gechillt-songs/213PIxJ-DDs_",
          "name": "vom deich gechillt"
        }
      ],
      "trackId": "EwyHVh1k",
      "albumUrl": "https://www.jiosaavn.com/album/here/ZpeSMpqWsBw_",
      "language": "instrumental",
      "copyright": "© 2025 vom deich gechillt",
      "hasLyrics": false,
      "playCount": 1,
      "durationMs": 347000,
      "isExplicit": false,
      "releaseYear": "2025"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/GlkpQj5BQHc",
      "type": "track",
      "album": "Night Fairy",
      "image": "https://c.saavncdn.com/966/Night-Fairy-Instrumental-2026-20260410210403-500x500.jpg",
      "label": "Jackey Music Company",
      "title": "Blinding Lights",
      "artist": "Jackey Mishra",
      "albumId": "74456323",
      "artists": [
        {
          "id": "12204294",
          "url": "https://www.jiosaavn.com/artist/jackey-mishra-songs/UWFnR9sPLk8_",
          "name": "Jackey Mishra",
          "image": "https://c.saavncdn.com/artists/Jackey_Mishra_004_20251201102541_500x500.jpg"
        }
      ],
      "trackId": "j1BsJqwD",
      "albumUrl": "https://www.jiosaavn.com/album/night-fairy/pQQFTbH3EgM_",
      "language": "english",
      "copyright": "© 2026 Jackey Music Company",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 216000,
      "isExplicit": false,
      "releaseYear": "2026"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/MjsTa0BmY1s",
      "type": "track",
      "album": "Blinding Lights Piano Chill",
      "image": "https://c.saavncdn.com/706/Blinding-Lights-Piano-Chill-Instrumental-2020-20250407200937-500x500.jpg",
      "label": "Richard Ottis Charles",
      "title": "Blinding Lights",
      "artist": "Richard Ottis Charles",
      "albumId": "19430181",
      "artists": [
        {
          "id": "7711852",
          "url": "https://www.jiosaavn.com/artist/richard-ottis-charles-songs/awX0l0YwlS8_",
          "name": "Richard Ottis Charles"
        }
      ],
      "trackId": "BSxZ4VTh",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights-piano-chill/VYzxR69R3OA_",
      "language": "instrumental",
      "copyright": "℗ 2020 Richard Ottis Charles",
      "hasLyrics": false,
      "playCount": 4,
      "durationMs": 216000,
      "isExplicit": false,
      "releaseYear": "2020"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/PR8qeTwHYHo",
      "type": "track",
      "album": "The Lockdown Sessions",
      "image": "https://c.saavncdn.com/686/The-Lockdown-Sessions-Instrumental-2020-20200909001234-500x500.jpg",
      "label": "Glas Quartet",
      "title": "Blinding Lights",
      "artist": "Glas Quartet",
      "albumId": "22384773",
      "artists": [
        {
          "id": "8629309",
          "url": "https://www.jiosaavn.com/artist/glas-quartet-songs/K,blzeQT7ig_",
          "name": "Glas Quartet"
        }
      ],
      "trackId": "MwAHH7WI",
      "albumUrl": "https://www.jiosaavn.com/album/the-lockdown-sessions/VTL7YF4s6tY_",
      "language": "instrumental",
      "copyright": "℗ 2020 Glas Quartet",
      "hasLyrics": false,
      "playCount": 1,
      "durationMs": 205000,
      "isExplicit": false,
      "releaseYear": "2020"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/PQ0uegJTeGM",
      "type": "track",
      "album": "Blinding Lights (Remixes)",
      "image": "https://c.saavncdn.com/707/Blinding-Lights-Remixes--Instrumental-2021-20211012060517-500x500.jpg",
      "label": "Garage 90",
      "title": "Blinding Lights",
      "artist": "Taradu",
      "albumId": "30263561",
      "artists": [
        {
          "id": "4442776",
          "url": "https://www.jiosaavn.com/artist/taradu-songs/vwDPpe6Td6A_",
          "name": "Taradu"
        }
      ],
      "trackId": "MeEKvcOP",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights-remixes/L9T6owPW5D4_",
      "language": "instrumental",
      "copyright": "℗ 2021 Garage 90",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 301000,
      "isExplicit": false,
      "releaseYear": "2021"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/KTENQDdnbls",
      "type": "track",
      "album": "Blinding Lights (Remixes)",
      "image": "https://c.saavncdn.com/707/Blinding-Lights-Remixes--Instrumental-2021-20211012060517-500x500.jpg",
      "label": "Garage 90",
      "title": "Blinding Lights",
      "artist": "Taradu",
      "albumId": "30263561",
      "artists": [
        {
          "id": "4442776",
          "url": "https://www.jiosaavn.com/artist/taradu-songs/vwDPpe6Td6A_",
          "name": "Taradu"
        }
      ],
      "trackId": "YYfqCWYh",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights-remixes/L9T6owPW5D4_",
      "language": "instrumental",
      "copyright": "℗ 2021 Garage 90",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 310000,
      "isExplicit": false,
      "releaseYear": "2021"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/OiNcXUR,GlY",
      "type": "track",
      "album": "Covers, Vol. 2",
      "image": "https://c.saavncdn.com/699/Covers-Vol-2-Instrumental-2026-20260106110208-500x500.jpg",
      "label": "Midnight Library Records UK",
      "title": "Blinding Lights",
      "artist": "The Midnight Library",
      "albumId": "71344539",
      "artists": [
        {
          "id": "23569770",
          "url": "https://www.jiosaavn.com/artist/the-midnight-library-songs/DneGDkzIpgc_",
          "name": "The Midnight Library"
        }
      ],
      "trackId": "JK7l0N-e",
      "albumUrl": "https://www.jiosaavn.com/album/covers-vol.-2/kPKvfSwpSV0_",
      "language": "instrumental",
      "copyright": "© 2026 The Weeknd, Harry Styles, The Neighbourhood, Drake, Lady Gaga, Bruno Mars, Tom Odell, Coldplay, SOLOMON, Miley Cyrus, Pheelz",
      "hasLyrics": false,
      "playCount": 1,
      "durationMs": 174000,
      "isExplicit": false,
      "releaseYear": "2026"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/My08BxlhXmI",
      "type": "track",
      "album": "Mainstream Overtures",
      "image": "https://c.saavncdn.com/809/Mainstream-Overtures-Instrumental-2026-20260505080135-500x500.jpg",
      "label": "Giacomo Bucci Music",
      "title": "Blinding Lights",
      "artist": "Giacomo Bucci",
      "albumId": "72045482",
      "artists": [
        {
          "id": "1963372",
          "url": "https://www.jiosaavn.com/artist/giacomo-bucci-songs/CPdLcKhaR3c_",
          "name": "Giacomo Bucci"
        }
      ],
      "trackId": "CEW6mQiQ",
      "albumUrl": "https://www.jiosaavn.com/album/mainstream-overtures/2UEB2zbPo6w_",
      "language": "instrumental",
      "copyright": "© 2026 Original authors. Arrangement: Giacomo Bucci. Original publishers",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 183000,
      "isExplicit": false,
      "releaseYear": "2026"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/HVsJWyRheWM",
      "type": "track",
      "album": "Blinding Lights",
      "image": "https://c.saavncdn.com/591/Blinding-Lights-Instrumental-2024-20241108081222-500x500.jpg",
      "label": "7clouds",
      "title": "Blinding Lights",
      "artist": "Joowel",
      "albumId": "59464652",
      "artists": [
        {
          "id": "19876224",
          "url": "https://www.jiosaavn.com/artist/joowel-songs/8zMuispiWPI_",
          "name": "Joowel"
        }
      ],
      "trackId": "m3bjPQNP",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/83SauLgLNbA_",
      "language": "instrumental",
      "copyright": "© 2024 the Weeknd",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 175000,
      "isExplicit": false,
      "releaseYear": "2024"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/AFlYc0FpUGw",
      "type": "track",
      "album": "Blinding Lights",
      "image": "https://c.saavncdn.com/592/Blinding-Lights-Instrumental-2025-20250205121102-500x500.jpg",
      "label": "Mxsclx GTR Playa",
      "title": "Blinding Lights",
      "artist": "Muscle GT",
      "albumId": "61779218",
      "artists": [
        {
          "id": "15641487",
          "url": "https://www.jiosaavn.com/artist/muscle-gt-songs/UvdnHIeyzbI_",
          "name": "Muscle GT"
        }
      ],
      "trackId": "p13B5Yg_",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/lTdFjRk42UM_",
      "language": "instrumental",
      "copyright": "© 2025 The weekend",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 178000,
      "isExplicit": false,
      "releaseYear": "2025"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/BQYRcC1XU0M",
      "type": "track",
      "album": "Blinding Lights (Remixes)",
      "image": "https://c.saavncdn.com/707/Blinding-Lights-Remixes--Instrumental-2021-20211012060517-500x500.jpg",
      "label": "Garage 90",
      "title": "Blinding Lights",
      "artist": "Taradu",
      "albumId": "30263561",
      "artists": [
        {
          "id": "4442776",
          "url": "https://www.jiosaavn.com/artist/taradu-songs/vwDPpe6Td6A_",
          "name": "Taradu"
        }
      ],
      "trackId": "unzAYgdp",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights-remixes/L9T6owPW5D4_",
      "language": "instrumental",
      "copyright": "℗ 2021 Garage 90",
      "hasLyrics": false,
      "playCount": 3,
      "durationMs": 125000,
      "isExplicit": false,
      "releaseYear": "2021"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/QhEcXB9YWGU",
      "type": "track",
      "album": "Blinding Lights (Remixes)",
      "image": "https://c.saavncdn.com/707/Blinding-Lights-Remixes--Instrumental-2021-20211012060517-500x500.jpg",
      "label": "Garage 90",
      "title": "Blinding Lights",
      "artist": "Taradu",
      "albumId": "30263561",
      "artists": [
        {
          "id": "4442776",
          "url": "https://www.jiosaavn.com/artist/taradu-songs/vwDPpe6Td6A_",
          "name": "Taradu"
        }
      ],
      "trackId": "2ywmkhoV",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights-remixes/L9T6owPW5D4_",
      "language": "instrumental",
      "copyright": "℗ 2021 Garage 90",
      "hasLyrics": false,
      "playCount": 0,
      "durationMs": 342000,
      "isExplicit": false,
      "releaseYear": "2021"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/GFAzXCZJXwY",
      "type": "track",
      "album": "Blinding Lights",
      "image": "https://c.saavncdn.com/764/Blinding-Lights-Instrumental-2024-20260512120428-500x500.jpg",
      "label": "TommyMuzzic",
      "title": "Blinding Lights",
      "artist": "TommyMuzzic",
      "albumId": "52221856",
      "artists": [
        {
          "id": "16612924",
          "url": "https://www.jiosaavn.com/artist/tommymuzzic-songs/rtNeWt4NpzE_",
          "name": "TommyMuzzic"
        }
      ],
      "trackId": "h8XmRyh5",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/wnqBe9P5YZA_",
      "language": "instrumental",
      "copyright": "© 2024 the Weeknd",
      "hasLyrics": false,
      "playCount": 39,
      "durationMs": 200000,
      "isExplicit": false,
      "releaseYear": "2024"
    },
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights/PisCAQUFcH0",
      "type": "track",
      "album": "blinding lights",
      "image": "https://c.saavncdn.com/005/blinding-lights-Instrumental-2024-20241212132635-500x500.jpg",
      "label": "vom deich gechillt",
      "title": "blinding lights",
      "artist": "vom deich gechillt",
      "albumId": "60458718",
      "artists": [
        {
          "id": "17497585",
          "url": "https://www.jiosaavn.com/artist/vom-deich-gechillt-songs/213PIxJ-DDs_",
          "name": "vom deich gechillt"
        }
      ],
      "trackId": "NCi0q5GN",
      "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/e7KhcOriUVI_",
      "language": "instrumental",
      "copyright": "© 2024 vom deich gechillt",
      "hasLyrics": false,
      "playCount": 1,
      "durationMs": 347000,
      "isExplicit": false,
      "releaseYear": "2024"
    }
  ],
  "hasMore": true,
  "nextPage": 2
}
```

---

### Song Detail

Fetch full metadata for a single song by ID or URL.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/music:jiosaavn/song/:id`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | Track ID (e.g. UkVRAJEJ) OR canonical web URL with /song/<slug>/<token> path |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:jiosaavn/song/:id" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:jiosaavn/song/:id", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/music:jiosaavn/song/:id",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "url": "https://www.jiosaavn.com/song/blinding-lights-techno/JQM9YzV6cnk",
  "album": "Blinding Lights",
  "image": "https://c.saavncdn.com/004/Blinding-Lights-Instrumental-2024-20250116131427-500x500.jpg",
  "label": "Glowave Town",
  "title": "Blinding Lights (Techno)",
  "artist": "Error404, Glowave Town",
  "albumId": "54994972",
  "preview": "https://preview.saavncdn.com/004/aSkZGNeYUxQYjx5ssXu8QYeyJWIP6nHJ5BvlovKqcHpfP_96_p.mp4",
  "trackId": "UkVRAJEJ",
  "albumUrl": "https://www.jiosaavn.com/album/blinding-lights/pDR8bo-PMDA_",
  "language": "instrumental",
  "copyright": "© 2024 the Weeknd",
  "hasLyrics": false,
  "playCount": 45,
  "durationMs": 154000,
  "isExplicit": false,
  "releaseDate": "2024-06-14",
  "releaseYear": "2024"
}
```

---

### Playlist Detail

Fetch playlist info with tracklist.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/music:jiosaavn/playlist/:id`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | Playlist token (URL last segment), numeric listid (e.g. 47599074), or full canonical playlist URL |
| `limit` | number | query | no | Tracks per page (1-50). Default: 30 |
| `page` | number | query | no | Page 1-based. Default: 1 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:jiosaavn/playlist/:id?limit=30&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:jiosaavn/playlist/:id?limit=30&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/music:jiosaavn/playlist/:id?limit=30&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "url": "https://www.jiosaavn.com/featured/now-trending/BECHl0fsh08_",
  "page": 1,
  "image": "https://c.saavncdn.com/editorial/NowTrending_20260423085344.jpg?bch=1776936232",
  "owner": "JioSaavn",
  "title": "Now Trending",
  "tracks": [
    {
      "url": "https://www.jiosaavn.com/song/bairan/HRoqBycHAnU",
      "album": "Bairan",
      "image": "https://c.saavncdn.com/238/Bairan-Unknown-2026-20260223182954-500x500.jpg",
      "title": "Bairan",
      "artist": "Banjaare",
      "albumId": "72717346",
      "trackId": "mrA6S75F",
      "language": "haryanvi",
      "playCount": 12663931,
      "durationMs": 150000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/sheesha-aakhya-mai-aakh-ghali-jo-bairan/KCUfUgRmDwY",
      "album": "Sheesha (Aakhya Mai Aakh Ghali Jo Bairan)",
      "image": "https://c.saavncdn.com/034/Sheesha-Aakhya-Mai-Aakh-Ghali-Jo-Beran-Unknown-2026-20260123134431-500x500.jpg",
      "title": "Sheesha (Aakhya Mai Aakh Ghali Jo Bairan)",
      "artist": "Mitta Ror, Swara Verma",
      "albumId": "71448075",
      "trackId": "XMtcpV85",
      "language": "haryanvi",
      "playCount": 7837091,
      "durationMs": 196000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/chand-mera-dil-title-track/XQssWg4AeVY",
      "album": "Chand Mera Dil (Title Track)",
      "image": "https://c.saavncdn.com/299/Chand-Mera-Dil-Title-Track-Hindi-2026-20260411122555-500x500.jpg",
      "title": "Chand Mera Dil (Title Track)",
      "artist": "Amitabh Bhattacharya, Sachin-Jigar, Faheem Abdullah",
      "albumId": "74476597",
      "trackId": "-cGkz0Ne",
      "language": "hindi",
      "playCount": 1367950,
      "durationMs": 280000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/sitaare-from-ikkis/HwINSA5UBWA",
      "album": "Ikkis",
      "image": "https://c.saavncdn.com/988/Ikkis-Hindi-2025-20251226143212-500x500.jpg",
      "title": "Sitaare (From \"Ikkis\")",
      "artist": "Amitabh Bhattacharya, Arijit Singh, Sachin-Jigar",
      "albumId": "71039387",
      "trackId": "ojfyzd2S",
      "language": "hindi",
      "playCount": 15266184,
      "durationMs": 242000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/zara-sa/JjkbABFoQlQ",
      "album": "Jannat",
      "image": "https://c.saavncdn.com/801/Jannat-Hindi-2008-20190629135803-500x500.jpg",
      "title": "Zara Sa",
      "artist": "Sayeed Quadri, Pritam, KK",
      "albumId": "1031998",
      "trackId": "VQp1eXug",
      "language": "hindi",
      "playCount": 176369875,
      "durationMs": 302000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/aitbaar-from-chand-mera-dil/XVoRYxMET2Y",
      "album": "Aitbaar (From \"Chand Mera Dil\")",
      "image": "https://c.saavncdn.com/419/Aitbaar-From-Chand-Mera-Dil-Hindi-2026-20260421110433-500x500.jpg",
      "title": "Aitbaar (From \"Chand Mera Dil\")",
      "artist": "Amitabh Bhattacharya, Sachin-Jigar, Faheem Abdullah",
      "albumId": "74839157",
      "trackId": "-2zRg4xU",
      "language": "hindi",
      "playCount": 488177,
      "durationMs": 228000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/samjhawan/NCUEfRBHfQQ",
      "album": "Humpty Sharma Ki Dulhania",
      "image": "https://c.saavncdn.com/540/Humpty-Sharma-Ki-Dulhania-Hindi-2014-20190618095042-500x500.jpg",
      "title": "Samjhawan",
      "artist": "Jawad Ahmad, Sharib Toshi, Arijit Singh, Shreya Ghoshal",
      "albumId": "1161976",
      "trackId": "DMoLdwJ7",
      "language": "hindi",
      "playCount": 168946971,
      "durationMs": 269000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/ae-dil-hai-mushkil-title-track/Cg0AdD0DeQU",
      "album": "Ae Dil Hai Mushkil",
      "image": "https://c.saavncdn.com/257/Ae-Dil-Hai-Mushkil-Hindi-2016-500x500.jpg",
      "title": "Ae Dil Hai Mushkil Title Track",
      "artist": "Pritam, Arijit Singh",
      "albumId": "2597301",
      "trackId": "zekEI3N6",
      "language": "hindi",
      "playCount": 293219893,
      "durationMs": 268000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/hamari-adhuri-kahani-title-track/EScueywdQkE",
      "album": "Hamari Adhuri Kahani",
      "image": "https://c.saavncdn.com/577/Hamari-Adhuri-Kahani-Hindi-2015-500x500.jpg",
      "title": "Hamari Adhuri Kahani (Title Track)",
      "artist": "Jeet Gannguli, Arijit Singh, Rashmi-Virag",
      "albumId": "1243478",
      "trackId": "aOEJX-ur",
      "language": "hindi",
      "playCount": 210093326,
      "durationMs": 398000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/shayad/LxohXBZ7ZGM",
      "album": "Love Aaj Kal",
      "image": "https://c.saavncdn.com/862/Love-Aaj-Kal-Hindi-2020-20200214140423-500x500.jpg",
      "title": "Shayad",
      "artist": "Pritam, Arijit Singh",
      "albumId": "19072107",
      "trackId": "_rJmbKSP",
      "language": "hindi",
      "playCount": 324715956,
      "durationMs": 247000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/bandeya-from-dil-juunglee/MlgAZyd9RXA",
      "album": "Bandeya (From \"Dil Juunglee\")",
      "image": "https://c.saavncdn.com/267/Bandeya-From-Dil-Juunglee--Hindi-2018-20180222044014-500x500.jpg",
      "title": "Bandeya (From \"Dil Juunglee\")",
      "artist": "Sharib Toshi, Arijit Singh",
      "albumId": "12293787",
      "trackId": "B0kVSMrC",
      "language": "hindi",
      "playCount": 99213444,
      "durationMs": 185000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/mere-bina/BCc0dk1aeEc",
      "album": "Crook",
      "image": "https://c.saavncdn.com/330/Crook-Hindi-2010-20190603132556-500x500.jpg",
      "title": "Mere Bina",
      "artist": "Pritam, Nikhil D'souza",
      "albumId": "1024308",
      "trackId": "tO_G9jOt",
      "language": "hindi",
      "playCount": 37076914,
      "durationMs": 291000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/dekhha-tenu-from-mr.-and-mrs.-mahi/FD0kBzIGW30",
      "album": "Mr. And Mrs. Mahi",
      "image": "https://c.saavncdn.com/619/Mr-And-Mrs-Mahi-Hindi-2024-20240524142048-500x500.jpg",
      "title": "Dekhha Tenu (From \"Mr. And Mrs. Mahi\")",
      "artist": "Jaani, Mohammad Faiz",
      "albumId": "54613181",
      "trackId": "dUO6F6lN",
      "language": "hindi",
      "playCount": 24110035,
      "durationMs": 281000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/kesariya-from-brahmastra/NQotZhVbc0A",
      "album": "Kesariya (From \"Brahmastra\")",
      "image": "https://c.saavncdn.com/191/Kesariya-From-Brahmastra-Hindi-2022-20220717092820-500x500.jpg",
      "title": "Kesariya (From \"Brahmastra\")",
      "artist": "Pritam, Arijit Singh, Amitabh Bhattacharya",
      "albumId": "36552397",
      "trackId": "EbFWakDs",
      "language": "hindi",
      "playCount": 210475259,
      "durationMs": 268000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/aashiq-tera/PhodUBlCRwU",
      "album": "Happy Bhag Jayegi",
      "image": "https://c.saavncdn.com/189/Happy-Bhag-Jayegi-Hindi-2025-20250930143727-500x500.jpg",
      "title": "Aashiq Tera",
      "artist": "Sohail Sen, Altamash Faridi",
      "albumId": "33179525",
      "trackId": "Nrvamrp6",
      "language": "hindi",
      "playCount": 10691572,
      "durationMs": 294000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/tu-hi-haqeeqat/JwEndwJYbkM",
      "album": "Tum Mile",
      "image": "https://c.saavncdn.com/316/Tum-Mile-Hindi-2009-20260120201221-500x500.jpg",
      "title": "Tu Hi Haqeeqat",
      "artist": "Pritam, Javed Ali, Irshan Ashraf, Shadab, Sayeed Quadri",
      "albumId": "1052521",
      "trackId": "WiLFvhYp",
      "language": "hindi",
      "playCount": 66931814,
      "durationMs": 302000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/jannat-jahan/BiEHfkxFf1A",
      "album": "Jannat",
      "image": "https://c.saavncdn.com/801/Jannat-Hindi-2008-20190629135803-500x500.jpg",
      "title": "Jannat Jahan",
      "artist": "Pritam, Rupam Islam",
      "albumId": "1031998",
      "trackId": "vIlO8uHc",
      "language": "hindi",
      "playCount": 6463429,
      "durationMs": 223000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/tum-mile/IS4nSDBmTlU",
      "album": "Tum Mile",
      "image": "https://c.saavncdn.com/316/Tum-Mile-Hindi-2009-20260120201221-500x500.jpg",
      "title": "Tum Mile",
      "artist": "Pritam, Neeraj Shridhar",
      "albumId": "1052521",
      "trackId": "QFLyDVyf",
      "language": "hindi",
      "playCount": 49959383,
      "durationMs": 343000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/sang-hoon-tere/RiAaSxpyUAM",
      "album": "Jannat 2",
      "image": "https://c.saavncdn.com/584/Jannat-2-Hindi-2012-20260120201301-500x500.jpg",
      "title": "Sang Hoon Tere",
      "artist": "Sayeed Quadri, Pritam, Nikhil D'souza",
      "albumId": "1032000",
      "trackId": "6HqznBg0",
      "language": "hindi",
      "playCount": 15011718,
      "durationMs": 265000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/maahi/Ri0hdRxeRgc",
      "album": "RAAZ - The Mystery Continues",
      "image": "https://c.saavncdn.com/542/RAAZ-The-Mystery-Continues-Hindi-2008-20190617160418-500x500.jpg",
      "title": "Maahi",
      "artist": "Sharib Toshi, Sayeed Quadri",
      "albumId": "1044114",
      "trackId": "6EJDhnq4",
      "language": "hindi",
      "playCount": 43721847,
      "durationMs": 329000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/tujhe-sochta-hoon/NiQ9SQVaZGc",
      "album": "Jannat 2",
      "image": "https://c.saavncdn.com/584/Jannat-2-Hindi-2012-20260120201301-500x500.jpg",
      "title": "Tujhe Sochta Hoon",
      "artist": "Sayeed Quadri, Pritam, KK",
      "albumId": "1032000",
      "trackId": "FLVxqjST",
      "language": "hindi",
      "playCount": 57532471,
      "durationMs": 314000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/o-meri-jaan/EyA7e0IBR2Y",
      "album": "Life In A Metro",
      "image": "https://c.saavncdn.com/457/Life-In-A-Metro-Hindi-2007-20220321185258-500x500.jpg",
      "title": "O Meri Jaan",
      "artist": "Pritam, KK",
      "albumId": "1036139",
      "trackId": "cHPJ61pU",
      "language": "hindi",
      "playCount": 6501220,
      "durationMs": 305000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/in-dino/Iz4naBdBQQU",
      "album": "Life In A Metro",
      "image": "https://c.saavncdn.com/457/Life-In-A-Metro-Hindi-2007-20220321185258-500x500.jpg",
      "title": "In Dino",
      "artist": "Pritam, Soham, Sayeed Quadri",
      "albumId": "1036139",
      "trackId": "SVLYcqv6",
      "language": "hindi",
      "playCount": 20730717,
      "durationMs": 397000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/dil-ibaadat/HgdfZERjZwM",
      "album": "Tum Mile",
      "image": "https://c.saavncdn.com/316/Tum-Mile-Hindi-2009-20260120201221-500x500.jpg",
      "title": "Dil Ibaadat",
      "artist": "Pritam, KK, Sayeed Quadri",
      "albumId": "1052521",
      "trackId": "no4U0SP0",
      "language": "hindi",
      "playCount": 113870515,
      "durationMs": 329000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/sanam-teri-kasam/GB4-dAV4WFs",
      "album": "Sanam Teri Kasam",
      "image": "https://c.saavncdn.com/150/Sanam-Teri-Kasam-Hindi-2025-20260404111304-500x500.jpg",
      "title": "Sanam Teri Kasam",
      "artist": "Himesh Reshammiya, Ankit Tiwari, Palak Muchhal",
      "albumId": "33008911",
      "trackId": "hvTEqHoh",
      "language": "hindi",
      "playCount": 76497068,
      "durationMs": 314000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/tere-bina%c2%a0/BQEfSw1bTQs",
      "album": "Guru",
      "image": "https://c.saavncdn.com/020/Guru-Hindi-2006-20190516131307-500x500.jpg",
      "title": "Tere Bina ",
      "artist": "A.R. Rahman, Chinmayi, Murtuza Khan, Qadir Khan",
      "albumId": "1028969",
      "trackId": "uitzykz8",
      "language": "hindi",
      "playCount": 42817764,
      "durationMs": 309000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/mann-mera-original-version/JF48Bwx1eFY",
      "album": "Mann Mera (Original Version)",
      "image": "https://c.saavncdn.com/451/Mann-Mera-Original-Version-Hindi-2025-20250508175517-500x500.jpg",
      "title": "Mann Mera (Original Version)",
      "artist": "Gajendra Verma",
      "albumId": "64424344",
      "trackId": "T6W6xEOe",
      "language": "hindi",
      "playCount": 9260345,
      "durationMs": 228000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/raataan-lambiyan/HTg-QzBjQl0",
      "album": "Shershaah",
      "image": "https://c.saavncdn.com/238/Shershaah-Original-Motion-Picture-Soundtrack--Hindi-2021-20210815181610-500x500.jpg",
      "title": "Raataan Lambiyan",
      "artist": "Tanishk Bagchi, Jubin Nautiyal, Asees Kaur",
      "albumId": "29060166",
      "trackId": "mPTrDSun",
      "language": "hindi",
      "playCount": 477588401,
      "durationMs": 230000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/koi-naa-from-bhool-chuk-maaf/QC0SayVxUWs",
      "album": "Koi Naa (From \"Bhool Chuk Maaf\")",
      "image": "https://c.saavncdn.com/620/Koi-Naa-From-Bhool-Chuk-Maaf-Hindi-2025-20250416112929-500x500.jpg",
      "title": "Koi Naa (From \"Bhool Chuk Maaf\")",
      "artist": "Tanishk Bagchi, Gifty, Harnoor, Shreya Ghoshal, Irshad Kamil",
      "albumId": "63815497",
      "trackId": "0EyZQAfX",
      "language": "hindi",
      "playCount": 4739054,
      "durationMs": 221000,
      "isExplicit": false
    },
    {
      "url": "https://www.jiosaavn.com/song/ishq-di-baajiyaan/XRIMUC5Dc1Q",
      "album": "Soorma",
      "image": "https://c.saavncdn.com/193/Soorma-Hindi-2018-20180702111043-500x500.jpg",
      "title": "Ishq Di Baajiyaan",
      "artist": "Diljit Dosanjh, Shankar-Ehsaan-Loy",
      "albumId": "13301671",
      "trackId": "-zgaZsDg",
      "language": "hindi",
      "playCount": 22601697,
      "durationMs": 287000,
      "isExplicit": false
    }
  ],
  "hasMore": true,
  "fanCount": 0,
  "nextPage": 2,
  "playlistId": "47599074",
  "trackCount": 37,
  "description": "37 songs with music from artists like Banjaare, Mitta Ror, Swara Verma, and more.",
  "lastUpdated": "1776934432",
  "followerCount": 58405
}
```

---

### Album Detail

Fetch album info with its tracklist.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/music:jiosaavn/album/:id`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | Album token (last URL segment) or full canonical album URL |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:jiosaavn/album/:id" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:jiosaavn/album/:id", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/music:jiosaavn/album/:id",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "url": "https://www.jiosaavn.com/album/blinding-lights/pDR8bo-PMDA_",
  "image": "https://c.saavncdn.com/004/Blinding-Lights-Instrumental-2024-20250116131427-500x500.jpg",
  "title": "Blinding Lights",
  "artist": "Error404,  Glowave Town",
  "tracks": [
    {
      "url": "https://www.jiosaavn.com/song/blinding-lights-techno/JQM9YzV6cnk",
      "image": "https://c.saavncdn.com/004/Blinding-Lights-Instrumental-2024-20250116131427-500x500.jpg",
      "title": "Blinding Lights (Techno)",
      "artist": "Error404, Glowave Town",
      "trackId": "UkVRAJEJ",
      "language": "instrumental",
      "playCount": 45,
      "durationMs": 154000,
      "isExplicit": false
    }
  ],
  "albumId": "54994972",
  "language": "instrumental",
  "copyright": "© 2024 the Weeknd",
  "playCount": 0,
  "isExplicit": false,
  "trackCount": 1,
  "description": "2024 · Instrumental Album · Error404 and Glowave Town",
  "releaseYear": "2024"
}
```

---


_Generated: 2026-08-02T14:32:02.975Z_