zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Music/Spotify
Logo Spotify

Spotify

Search tracks, albums, and artists on Spotify. Returns metadata + 30s preview URLs. Full audio is DRM-protected.

Endpoints
4
Requests
32
Updated
3 months ago
For LLMs
llms.txt
Endpoint health22 hours ago
  • searchpassing, 2.2s
  • trackpassing, 0.3s
  • albumpassing, 1.5s
  • artistpassing, 0.8s
4/4 passingdaily 01:00 WIB

Playground

4 endpoints
GET/v1/music:spotify/search5m cache3 paramschecking key…
Parameters
qstringrequired

Search query

typeenum

Filter: track|album|artist|all. Default all

pagenumber

Page 1-based, 20 items per page. Default 1

·
Response
EXAMPLE
{
  "page": 1,
  "count": 20,
  "items": [
    {
      "uri": "spotify:track:0VjIjW4GlUZAMYd2vXMi3b",
      "url": "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
      "album": "After Hours",
      "image": "https://i.scdn.co/image/ab67616d00001e028863bc11d2aa12b54f5aeb36",
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "trackId": "0VjIjW4GlUZAMYd2vXMi3b",
      "albumUri": "spotify:album:4yP0hdKOZPNshxUOjY0cZj",
      "playable": true,
      "artistIds": [
        "1Xyo4u8uXC1ZmMpatF05PJ"
      ],
      "durationMs": 200040
    },
    {
      "uri": "spotify:track:6qYkmqFsXbj8CQjAdbYz07",
      "url": "https://open.spotify.com/track/6qYkmqFsXbj8CQjAdbYz07",
      "album": "Blinding Lights",
      "image": "https://i.scdn.co/image/ab67616d00001e02a3eff72f62782fb589a492f9",
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "trackId": "6qYkmqFsXbj8CQjAdbYz07",
      "albumUri": "spotify:album:3sL9Myf7JF1k9TbrXE46ou",
      "playable": true,
      "artistIds": [
        "1Xyo4u8uXC1ZmMpatF05PJ"
      ],
      "durationMs": 200045
    },
    {
      "uri": "spotify:track:3KkXRkHbMCARz0aVfEt68P",
      "url": "https://open.spotify.com/track/3KkXRkHbMCARz0aVfEt68P",
      "album": "Spider-Man: Into the Spider-Verse (Soundtrack From & Inspired by the Motion Picture)",
      "image": "https://i.scdn.co/image/ab67616d00001e02e2e352d89826aef6dbd5ff8f",
      "title": "Sunflower - Spider-Man: Into the Spider-Verse",
      "artist": "Post Malone, Swae Lee",
      "trackId": "3KkXRkHbMCARz0aVfEt68P",
      "albumUri": "spotify:album:35s58BRTGAEWztPo9WqCIs",
      "playable": true,
      "artistIds": [
        "246dkjvS1zLTtiykXe5h60",
        "1zNqQNIdeOUZHb8zbZRFMX"
      ],
      "durationMs": 158040
    }
  ],
  "total": 1000,
  "hasMore": true,
  "nextPage": 2
}

Code examples

Search
zpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("music:spotify", "search", {
  "q": "blinding lights",
  "type": "track",
  "page": 1
});
console.log(data);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/v1/music:spotify/search?q=blinding+lights&type=track&page=1" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

4 endpoints · plain text
GETSearch/v1/music:spotify/searchSearch the catalog by text query.

Parameters

qstringrequired
Search query
typeenumoptional
Filter: track|album|artist|all. Default all Values: track, album, artist, all.
pagenumberoptional
Page 1-based, 20 items per page. Default 1

Request

curl -X GET "https://api.zpi.web.id/v1/music:spotify/search?q=blinding+lights&type=track&page=1" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "page": 1,
  "count": 20,
  "items": [
    {
      "uri": "spotify:track:0VjIjW4GlUZAMYd2vXMi3b",
      "url": "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
      "album": "After Hours",
      "image": "https://i.scdn.co/image/ab67616d00001e028863bc11d2aa12b54f5aeb36",
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "trackId": "0VjIjW4GlUZAMYd2vXMi3b",
      "albumUri": "spotify:album:4yP0hdKOZPNshxUOjY0cZj",
      "playable": true,
      "artistIds": [
        "1Xyo4u8uXC1ZmMpatF05PJ"
      ],
      "durationMs": 200040
    },
    {
      "uri": "spotify:track:6qYkmqFsXbj8CQjAdbYz07",
      "url": "https://open.spotify.com/track/6qYkmqFsXbj8CQjAdbYz07",
      "album": "Blinding Lights",
      "image": "https://i.scdn.co/image/ab67616d00001e02a3eff72f62782fb589a492f9",
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "trackId": "6qYkmqFsXbj8CQjAdbYz07",
      "albumUri": "spotify:album:3sL9Myf7JF1k9TbrXE46ou",
      "playable": true,
      "artistIds": [
        "1Xyo4u8uXC1ZmMpatF05PJ"
      ],
      "durationMs": 200045
    },
    {
      "uri": "spotify:track:3KkXRkHbMCARz0aVfEt68P",
      "url": "https://open.spotify.com/track/3KkXRkHbMCARz0aVfEt68P",
      "album": "Spider-Man: Into the Spider-Verse (Soundtrack From & Inspired by the Motion Picture)",
      "image": "https://i.scdn.co/image/ab67616d00001e02e2e352d89826aef6dbd5ff8f",
      "title": "Sunflower - Spider-Man: Into the Spider-Verse",
      "artist": "Post Malone, Swae Lee",
      "trackId": "3KkXRkHbMCARz0aVfEt68P",
      "albumUri": "spotify:album:35s58BRTGAEWztPo9WqCIs",
      "playable": true,
      "artistIds": [
        "246dkjvS1zLTtiykXe5h60",
        "1zNqQNIdeOUZHb8zbZRFMX"
      ],
      "durationMs": 158040
    }
  ],
  "total": 1000,
  "hasMore": true,
  "nextPage": 2
}
GETTrack Detail/v1/music:spotify/track/:idFetch full metadata for a single track by ID or URL.

Parameters

idstringrequiredin path
Track ID (22-char base62), URI form, or full track URL

Request

curl -X GET "https://api.zpi.web.id/v1/music:spotify/track/11dFghVXANMlKmJXsNCbNl" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "url": "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl",
  "image": "https://image-cdn-ak.spotifycdn.com/image/ab67616d0000b2733188158b6cfdc17994be4c5f",
  "title": "Cut To The Feeling",
  "artist": "Carly Rae Jepsen",
  "artists": [
    {
      "id": "6sFIWsNpZYqfjUpaCgueju",
      "url": "https://open.spotify.com/artist/6sFIWsNpZYqfjUpaCgueju",
      "name": "Carly Rae Jepsen"
    }
  ],
  "preview": "https://p.scdn.co/mp3-preview/c011f4a360ae0ec93b366b5f328a17b2c5ae118d",
  "trackId": "11dFghVXANMlKmJXsNCbNl",
  "hasVideo": false,
  "durationMs": 207959,
  "isExplicit": false,
  "isPlayable": true,
  "releaseDate": "2017-05-26",
  "isNineteenPlus": false
}
GETAlbum Detail/v1/music:spotify/album/:idFetch album info with its tracklist.

Parameters

idstringrequiredin path
Album ID (22-char base62), URI form, or full album URL

Request

curl -X GET "https://api.zpi.web.id/v1/music:spotify/album/4yP0hdKOZPNshxUOjY0cZj" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "url": "https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj",
  "image": "https://image-cdn-ak.spotifycdn.com/image/ab67616d0000b2738863bc11d2aa12b54f5aeb36",
  "title": "After Hours",
  "artist": "The Weeknd",
  "tracks": [
    {
      "url": "https://open.spotify.com/track/6b5P51m8xx2XA6U7sdNZ5E",
      "title": "Alone Again",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/77e54c6064335e259d0f571768af5f96c22304d4",
      "trackId": "6b5P51m8xx2XA6U7sdNZ5E",
      "durationMs": 250053,
      "isExplicit": true,
      "trackNumber": 1
    },
    {
      "url": "https://open.spotify.com/track/2K9Ovn1o2bTGqbsABGC6m3",
      "title": "Too Late",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/2b7a3f91db7e2ce0526b45bc878c5277eb3df28a",
      "trackId": "2K9Ovn1o2bTGqbsABGC6m3",
      "durationMs": 239973,
      "isExplicit": true,
      "trackNumber": 2
    },
    {
      "url": "https://open.spotify.com/track/6kWxIqQDsKFYCJGbU4AjCX",
      "title": "Hardest To Love",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/0271808f406491a32f3ca28e11aa5faf600adf88",
      "trackId": "6kWxIqQDsKFYCJGbU4AjCX",
      "durationMs": 211400,
      "isExplicit": true,
      "trackNumber": 3
    },
    {
      "url": "https://open.spotify.com/track/4BGZF4oLbTL0pWm7C18pbv",
      "title": "Scared To Live",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/1682f650068ad5659508370192cc7854b454d166",
      "trackId": "4BGZF4oLbTL0pWm7C18pbv",
      "durationMs": 191306,
      "isExplicit": true,
      "trackNumber": 4
    },
    {
      "url": "https://open.spotify.com/track/3WlbeuhfRSqU7ylK2Ui5U7",
      "title": "Snowchild",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/145a6811b2f7d2489e50c1845ed47cfb5d8c4d8d",
      "trackId": "3WlbeuhfRSqU7ylK2Ui5U7",
      "durationMs": 247186,
      "isExplicit": true,
      "trackNumber": 5
    },
    {
      "url": "https://open.spotify.com/track/1sOW4PuG5X3Ie3EXUhAopJ",
      "title": "Escape From LA",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/098a07649cf6db99f150930fd732c2733cc2be90",
      "trackId": "1sOW4PuG5X3Ie3EXUhAopJ",
      "durationMs": 355960,
      "isExplicit": true,
      "trackNumber": 6
    },
    {
      "url": "https://open.spotify.com/track/6bnF93Rx87YqUBLSgjiMU8",
      "title": "Heartless",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/ffe5646cbee66e2a1bf7e0472cfed0ad777232b4",
      "trackId": "6bnF93Rx87YqUBLSgjiMU8",
      "durationMs": 198266,
      "isExplicit": true,
      "trackNumber": 7
    },
    {
      "url": "https://open.spotify.com/track/3orEOtd8CPL8GFlpRpKuoE",
      "title": "Faith",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/dd93b587cac54ed11b207dd704236fde6516512e",
      "trackId": "3orEOtd8CPL8GFlpRpKuoE",
      "durationMs": 283226,
      "isExplicit": true,
      "trackNumber": 8
    },
    {
      "url": "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/51c08d92815cce4ac2de94a7335a430b81234624",
      "trackId": "0VjIjW4GlUZAMYd2vXMi3b",
      "durationMs": 200040,
      "isExplicit": false,
      "trackNumber": 9
    },
    {
      "url": "https://open.spotify.com/track/7szuecWAPwGoV1e5vGu8tl",
      "title": "In Your Eyes",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/ad4adb8a7c82359d511f7d9900d9f3742e0d2932",
      "trackId": "7szuecWAPwGoV1e5vGu8tl",
      "durationMs": 237520,
      "isExplicit": true,
      "trackNumber": 10
    },
    {
      "url": "https://open.spotify.com/track/5QO79kh1waicV47BqGRL3g",
      "title": "Save Your Tears",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/4bb5ee4441a2342502372f80f78a92cf3fe22549",
      "trackId": "5QO79kh1waicV47BqGRL3g",
      "durationMs": 215626,
      "isExplicit": true,
      "trackNumber": 11
    },
    {
      "url": "https://open.spotify.com/track/40U8d12pC5UHqmHwXjHjjl",
      "title": "Repeat After Me (Interlude)",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/14171ddd9559bd25ed882ff1f62c9ad16a4c0f93",
      "trackId": "40U8d12pC5UHqmHwXjHjjl",
      "durationMs": 195813,
      "isExplicit": true,
      "trackNumber": 12
    },
    {
      "url": "https://open.spotify.com/track/2p8IUWQDrpjuFltbdgLOag",
      "title": "After Hours",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/2375bc6998d765b02b229ff44e5c3d7b75fff74a",
      "trackId": "2p8IUWQDrpjuFltbdgLOag",
      "durationMs": 361026,
      "isExplicit": false,
      "trackNumber": 13
    },
    {
      "url": "https://open.spotify.com/track/2BcnxwxBuar5wjCaLqm5N3",
      "title": "Until I Bleed Out",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/6afac5b510ec7203bcfa68c2c06bf89b36f1ed54",
      "trackId": "2BcnxwxBuar5wjCaLqm5N3",
      "durationMs": 190173,
      "isExplicit": true,
      "trackNumber": 14
    }
  ],
  "albumId": "4yP0hdKOZPNshxUOjY0cZj",
  "isExplicit": false,
  "popularity": 0,
  "totalTracks": 14
}
GETArtist Detail/v1/music:spotify/artist/:idFetch artist profile with top tracks and discography.

Parameters

idstringrequiredin path
Artist ID (22-char base62), URI form, or full artist URL
albumsLimitnumberoptional
Number of albums to fetch (1-50). Default 20

Request

curl -X GET "https://api.zpi.web.id/v1/music:spotify/artist/1Xyo4u8uXC1ZmMpatF05PJ?albumsLimit=20" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "url": "https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ",
  "name": "The Weeknd",
  "image": "https://image-cdn-fa.spotifycdn.com/image/ab6761610000e5ebc1719ac9e6a75c1c25835018",
  "artistId": "1Xyo4u8uXC1ZmMpatF05PJ",
  "followers": 0,
  "topTracks": [
    {
      "url": "https://open.spotify.com/track/7MXVkk9YMctZqd1Srtv4MB",
      "title": "Starboy",
      "artist": "The Weeknd, Daft Punk",
      "preview": "https://p.scdn.co/mp3-preview/57c1238d183c40da3157c2892346f58445b1377c",
      "trackId": "7MXVkk9YMctZqd1Srtv4MB",
      "durationMs": 230453,
      "isExplicit": true
    },
    {
      "url": "https://open.spotify.com/track/7CyPwkp0oE8Ro9Dd5CUDjW",
      "title": "One Of The Girls (with JENNIE, Lily Rose Depp)",
      "artist": "The Weeknd, JENNIE, Lily-Rose Depp",
      "preview": "https://p.scdn.co/mp3-preview/e5bb7776aff44435b938eb084b2eca23e6c7f5ed",
      "trackId": "7CyPwkp0oE8Ro9Dd5CUDjW",
      "durationMs": 244684,
      "isExplicit": false
    },
    {
      "url": "https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b",
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/51c08d92815cce4ac2de94a7335a430b81234624",
      "trackId": "0VjIjW4GlUZAMYd2vXMi3b",
      "durationMs": 200040,
      "isExplicit": false
    },
    {
      "url": "https://open.spotify.com/track/0FIDCNYYjNvPVimz5icugS",
      "title": "Timeless (feat Playboi Carti)",
      "artist": "The Weeknd, Playboi Carti",
      "preview": "https://p.scdn.co/mp3-preview/c27493ac0bcb3deb72a8e814ab6c7e8686cd2324",
      "trackId": "0FIDCNYYjNvPVimz5icugS",
      "durationMs": 256000,
      "isExplicit": true
    },
    {
      "url": "https://open.spotify.com/track/2LBqCSwhJGcFQeTHMVGwy3",
      "title": "Die For You",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/e2e1b4ba70ff241ce2ce7283a8f4c3cb086ac0bd",
      "trackId": "2LBqCSwhJGcFQeTHMVGwy3",
      "durationMs": 260253,
      "isExplicit": false
    },
    {
      "url": "https://open.spotify.com/track/5J4ZkQpzMUFojo1CtAZYpn",
      "title": "Love Me Harder",
      "artist": "Ariana Grande, The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/16f1d643c2378d5f2911042bacb5bb00aba766e7",
      "trackId": "5J4ZkQpzMUFojo1CtAZYpn",
      "durationMs": 236133,
      "isExplicit": false
    },
    {
      "url": "https://open.spotify.com/track/7fBv7CLKzipRk6EC6TWHOB",
      "title": "The Hills",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/30a8d26fa2b2e9a5a01007d71783510180e677ab",
      "trackId": "7fBv7CLKzipRk6EC6TWHOB",
      "durationMs": 242253,
      "isExplicit": true
    },
    {
      "url": "https://open.spotify.com/track/5QO79kh1waicV47BqGRL3g",
      "title": "Save Your Tears",
      "artist": "The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/4bb5ee4441a2342502372f80f78a92cf3fe22549",
      "trackId": "5QO79kh1waicV47BqGRL3g",
      "durationMs": 215626,
      "isExplicit": true
    },
    {
      "url": "https://open.spotify.com/track/1oFAF1hdPOickyHgbuRjyX",
      "title": "Save Your Tears (Remix) (with Ariana Grande) - Bonus Track",
      "artist": "The Weeknd, Ariana Grande",
      "preview": "https://p.scdn.co/mp3-preview/111eb776b2884b2940e31b769f5dd99e8cc6ce6c",
      "trackId": "1oFAF1hdPOickyHgbuRjyX",
      "durationMs": 191013,
      "isExplicit": false
    },
    {
      "url": "https://open.spotify.com/track/0VO8gYVDSwM1Qdd2GsMoYK",
      "title": "Moth To A Flame (with The Weeknd)",
      "artist": "Swedish House Mafia, The Weeknd",
      "preview": "https://p.scdn.co/mp3-preview/1115f3c666a5ec714e6c3a29121c863720c4059c",
      "trackId": "0VO8gYVDSwM1Qdd2GsMoYK",
      "durationMs": 234000,
      "isExplicit": false
    }
  ],
  "popularity": 0,
  "albumsCount": 0,
  "topTracksCount": 10
}

Related APIs

More in music

JioSaavn

music/jiosaavn

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

35 calls·5m cache

SoundCloud

music/soundcloud

Search tracks, fetch metadata, and extract full audio download URLs (progressive MP3 / HLS) for public SoundCloud tracks.

26 calls·5m cache

Deezer

music/deezer

Search tracks, albums, artists, and playlists on Deezer. Returns metadata + 30s preview URLs.

10 calls·5m cache

Apple Music

music/apple-music

Search tracks, albums, and artists via the iTunes catalog. Returns metadata + 30s preview URLs.

10 calls·5m cache

Genius

music/genius

Search songs and fetch full lyrics from Genius. Returns clean text with section markers preserved.

7 calls·5m cache

Shazam

music/shazam

Song search via the Shazam catalog, plus per-country chart top tracks. Note: audio-fingerprint recognition is not implemented.

8 calls·5m cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026