Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalogue, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn’t in the catalogue yet?

Yes, through the community Discord, on any tier.

Spotify

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

4 endpoints57 calls4/4 passing

Get API key

Search

Search the catalog by text query.

GET/v1/music:spotify/search

passing · 1.0s5m cache

Parameters

Name	Type	In	Description
q	string	query	Search query. Required.
type	enum	query	Filter: track\|album\|artist\|all. Default all. One of track, album, artist, all.
page	number	query	Page 1-based, 20 items per page. Default 1.

Example response

{"project":"music:spotify",  "data": {"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  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Track Detail

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

GET/v1/music:spotify/track/:id

passing · 0.3s5m cache

Parameters

Name	Type	In	Description
id	string	path	Track ID (22-char base62), URI form, or full track URL. Required.

Example response

{"project":"music:spotify",  "data": {"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  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Album Detail

Fetch album info with its tracklist.

GET/v1/music:spotify/album/:id

passing · 2.3s5m cache

Parameters

Name	Type	In	Description
id	string	path	Album ID (22-char base62), URI form, or full album URL. Required.

Example response

{"project":"music:spotify",  "data": {"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  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Artist Detail

Fetch artist profile with top tracks and discography.

GET/v1/music:spotify/artist/:id

passing · 1.5s5m cache

Parameters

Name	Type	In	Description
id	string	path	Artist ID (22-char base62), URI form, or full artist URL. Required.
albumsLimit	number	query	Number of albums to fetch (1-50). Default 20.

Example response

{"project":"music:spotify",  "data": {"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  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Try it

Live request with your key

const data = await client.run(  "music:spotify",  "search",  { q: "blinding lights", type: "track", page: 1 });

Spotify

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

4 endpoints57 calls4/4 passing

Get API key

Search the catalog by text query.

GET/v1/…spotify/search

passing · 1.0s5m cache

Try it

Parameters

string · query · required

Search query.

type

enum · query · optional

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

page

number · query · optional

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

Example response

{"project":"music:spotify",  "data": {"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  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Code

const data = await client.run(  "music:spotify",  "search",  { q: "blinding lights", type: "track", page: 1 });