Song search via the Shazam catalog, plus per-country chart top tracks. Note: audio-fingerprint recognition is not implemented.
recognizenot measuredsearchfailed the last checktrackfailed the last checktopfailed the last check/v1/music:shazam/recognize5m cache1 paramchecking key…// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";
const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });
const data = await client.run("music:shazam", "recognize", {
"audio": "clip.mp3"
});
console.log(data);curl -X POST "https://api.zpi.web.id/v1/music:shazam/recognize" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx" \
-F "audio=@/path/to/file.jpg"/v1/music:shazam/recognizeAudio fingerprint recognition (currently stub; use /search instead).audiofilerequiredin formcurl -X POST "https://api.zpi.web.id/v1/music:shazam/recognize" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"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
}/v1/music:shazam/searchSearch the catalog by text query.qstringrequiredtypesstringoptionalcountrystringoptionallimitnumberoptionalpagenumberoptionalcurl -X GET "https://api.zpi.web.id/v1/music:shazam/search?q=blinding+lights&types=songs%2Cartists&country=US&limit=10&page=1" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"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
}/v1/music:shazam/track/:trackIdFetch full metadata for a single track by ID or URL.trackIdstringrequiredin pathcountrystringoptionalcurl -X GET "https://api.zpi.web.id/v1/music:shazam/track/559284799?country=US" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"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"
}/v1/music:shazam/topTop chart tracks by country.countrystringoptionallimitnumberoptionalcurl -X GET "https://api.zpi.web.id/v1/music:shazam/top?country=US&limit=20" \
-H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"{
"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]"
}