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.

Shazam

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

4 endpoints8 calls1/2 passing

Get API key

Audio Recognize

Audio fingerprint recognition (currently stub; use /search instead).

POST/v1/music:shazam/recognize

not measured yet5m cache

Parameters

Name	Type	In	Description
audio	file	form	Audio clip (3-20s recommended). Format: mp3, wav, m4a, ogg, flac, webm. Max 25MB. Required.

Example response

{"project":"music:shazam",  "data": {"url":"https://www.shazam.com/track/875332300/kicau-mania-akbar-chalay-remix","isrc":"USA2P2626997","album":"Kicau Mania (Akbar Chalay Remix) - Single","genre":"Hip-Hop","image":"https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/0b/7e/37/0b7e3741-4470-b10b-638f-4bb7e514e652/823375146957_Cover.jpg/400x400cc.jpg","label":"Glitch Haus","title":"Kicau Mania (Akbar Chalay Remix)","artist":"Akbar Chalay","matched":true,"preview":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/54/18/37/54183732-7a1e-e54e-d3a8-011d8e92a680/mzaf_1247343445695872952.plus.aac.ep.m4a","trackId":"875332300","subtitle":"Akbar Chalay","elapsedMs":448,"appleMusic":null,"releaseDate":"2026","appleMusicId":null,"matchOffsetSec":3.896168212  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

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

Search

Search the catalog by text query.

GET/v1/music:shazam/search

failed last check5m cache

Parameters

Name	Type	In	Description
q	string	query	Search term (title, artist). Required.
types	string	query	Comma list: songs\|artists. Default: songs,artists.
country	string	query	2-letter ISO country (storefront). Default: US.
limit	number	query	Items per category (1-25). Default: 10.
page	number	query	Page 1-based. Default: 1.

Example response

{"project":"music:shazam",  "data": {"page":1,"count":11,    "items": [      {"url":"https://music.apple.com/us/album/blinding-lights/1488408555?i=1488408568","isrc":"USUG11904206","type":"track","album":"Blinding Lights - Single","genre":"R&B/Soul","image":"https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/a6/6e/bf/a66ebf79-5008-8948-b352-a790fc87446b/19UM1IM04638.rgb.jpg/1000x1000bb.jpg","title":"Blinding Lights","artist":"The Weeknd","preview":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/17/b4/8f/17b48f9a-0b93-6bb8-fe1d-3a16623c2cfb/mzaf_5437418013983768184.plus.aac.ep.m4a","trackId":"1488408568","durationMs":201570,"isExplicit":false,"releaseDate":"2019-11-29"      },      {"url":"https://music.apple.com/us/album/blinding-lights-remix/1542842760?i=1542842761","isrc":"USUG12004507","type":"track","album":"Blinding Lights (Remix) - Single","genre":"R&B/Soul","image":"https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/61/e7/3f/61e73f94-018d-5f50-50ec-8521952bc72e/20UM1IM11629.rgb.jpg/1000x1000bb.jpg","title":"Blinding Lights (Remix)","artist":"The Weeknd & ROSALÍA","preview":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/08/fe/de/08fede6c-762e-b24f-f4ff-a9e51bbde1cc/mzaf_5710142856850334281.plus.aac.ep.m4a","trackId":"1542842761","durationMs":216123,"isExplicit":false,"releaseDate":"2020-12-04"      },      {"url":"https://music.apple.com/us/album/blinding-lights/1513133938?i=1513133940","isrc":"USWB12001485","type":"track","album":"Blinding Lights - Single","genre":"Pop","image":"https://is1-ssl.mzstatic.com/image/thumb/Music113/v4/8a/e6/47/8ae64750-3dcf-ac4d-b0f6-c70c92893494/054391934000.jpg/1000x1000bb.jpg","title":"Blinding Lights","artist":"Teddy Swims","preview":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview125/v4/4f/3a/c6/4f3ac6e5-50a3-2045-cd71-e51d103c1ad6/mzaf_15926875879381807489.plus.aac.ep.m4a","trackId":"1513133940","durationMs":214875,"isExplicit":false,"releaseDate":"2020-05-15"      }    ],"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:shazam/track/:trackId

not measured yet5m cache

Parameters

Name	Type	In	Description
trackId	string	path	Numeric track ID. Required.
country	string	query	2-letter ISO storefront. Default: US.

Example response

{"project":"music:shazam",  "data": {"url":"https://www.shazam.com/track/559284799/killin-it-feat-nazar-tejun","alias":"killin-it-feat-nazar-tejun","genre":"Pop","image":"https://is1-ssl.mzstatic.com/image/thumb/Music114/v4/12/71/eb/1271ebd4-48e4-a2c4-a500-8d0c5293d162/5059713359979_cover.jpg/400x400cc.jpg",    "share": {"href":"https://www.shazam.com/track/559284799/killin-it-feat-nazar-tejun","text":"Killin It (feat. Nazar & Tejun) by Danny Ricch & Busy","image":"https://is1-ssl.mzstatic.com/image/thumb/Music114/v4/12/71/eb/1271ebd4-48e4-a2c4-a500-8d0c5293d162/5059713359979_cover.jpg/400x400cc.jpg","subject":"Killin It (feat. Nazar & Tejun) - Danny Ricch & Busy","twitter":"I used @Shazam to discover Killin It (feat. Nazar & Tejun) by Danny Ricch & Busy.","snapchat":"https://www.shazam.com/partner/sc/track/559284799"    },"title":"Killin It (feat. Nazar & Tejun)","artist":"Danny Ricch & Busy",    "artists": [      {"id":"42","alias":"danny-ricch","appleMusicId":"1555066250"      },      {"id":"42","alias":"busy","appleMusicId":"1578742019"      }    ],"trackId":"559284799","isExplicit":false,"imageBackground":"https://is1-ssl.mzstatic.com/image/thumb/Music114/v4/12/71/eb/1271ebd4-48e4-a2c4-a500-8d0c5293d162/5059713359979_cover.jpg/400x400cc.jpg"  },"timestamp":"2026-05-27T13:27:15Z"}

Errors

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

Top Charts

Top chart tracks by country.

GET/v1/music:shazam/top

passing · 0.3s5m cache

Parameters

Name	Type	In	Description
country	string	query	2-letter ISO country (US, ID, GB) or 'WORLD' for global. Default: WORLD.
limit	number	query	Max rows (1-200). Default: 50.

Example response

{"project":"music:shazam",  "data": {"count":20,    "items": [      {"rank":1,"type":"track","title":"Janice STFU","artist":"Drake"      },      {"rank":2,"type":"track","title":"Choosin' Texas","artist":"Ella Langley"      },      {"rank":3,"type":"track","title":"Spend Dat","artist":"Yung Miami"      },      {"rank":4,"type":"track","title":"Chicago","artist":"Michael Jackson"      },      {"rank":5,"type":"track","title":"So Easy (To Fall In Love)","artist":"Olivia Dean"      },      {"rank":6,"type":"track","title":"Go","artist":"The Chemical Brothers"      },      {"rank":7,"type":"track","title":"Freakin’ Out","artist":"Dexter and The Moonrocks"      },      {"rank":8,"type":"track","title":"Ran To Atlanta","artist":"Drake, Future & Molly Santana"      },      {"rank":9,"type":"track","title":"Risk It All","artist":"Bruno Mars"      },      {"rank":10,"type":"track","title":"Man I Need","artist":"Olivia Dean"      },      {"rank":11,"type":"track","title":"worry (Instrumental Ultra Slowed)","artist":"LONOWN & riserayss"      },      {"rank":12,"type":"track","title":"Shabang","artist":"Drake"      },      {"rank":13,"type":"track","title":"Self Aware","artist":"Temper City"      },      {"rank":14,"type":"track","title":"2 Hard 4 The Radio","artist":"Drake"      },      {"rank":15,"type":"track","title":"Superpowers","artist":"Daniel Caesar"      },      {"rank":16,"type":"track","title":"Raindance","artist":"Dave & Tems"      },      {"rank":17,"type":"track","title":"Cinderella (feat. Ty Dolla $ign)","artist":"Mac Miller"      },      {"rank":18,"type":"track","title":"Die On This Hill","artist":"SIENNA SPIRO"      },      {"rank":19,"type":"track","title":"Be Her","artist":"Ella Langley"      },      {"rank":20,"type":"track","title":"Dracula","artist":"Tame Impala"      }    ],"country":"US","chartDate":"Tuesday, 26 May 2026 [performance over the past 7 days]"  },"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:shazam",  "recognize",  { audio: "clip.mp3" });

Shazam

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

4 endpoints8 calls1/2 passing

Get API key

Audio fingerprint recognition (currently stub; use /search instead).

POST/v1/…shazam/recognize

not measured yet5m cache

Try it

Parameters

audio

file · form · required

Audio clip (3-20s recommended). Format: mp3, wav, m4a, ogg, flac, webm. Max 25MB.

Example response

{"project":"music:shazam",  "data": {"url":"https://www.shazam.com/track/875332300/kicau-mania-akbar-chalay-remix","isrc":"USA2P2626997","album":"Kicau Mania (Akbar Chalay Remix) - Single","genre":"Hip-Hop","image":"https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/0b/7e/37/0b7e3741-4470-b10b-638f-4bb7e514e652/823375146957_Cover.jpg/400x400cc.jpg","label":"Glitch Haus","title":"Kicau Mania (Akbar Chalay Remix)","artist":"Akbar Chalay","matched":true,"preview":"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/54/18/37/54183732-7a1e-e54e-d3a8-011d8e92a680/mzaf_1247343445695872952.plus.aac.ep.m4a","trackId":"875332300","subtitle":"Akbar Chalay","elapsedMs":448,"appleMusic":null,"releaseDate":"2026","appleMusicId":null,"matchOffsetSec":3.896168212  },"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:shazam",  "recognize",  { audio: "clip.mp3" });