# Shazam — Zapi reference

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

**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/shazam
- 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

---

## Shazam

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

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

**Tags:** music, search, charts

### Audio Recognize

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

- **Method:** `POST`
- **Endpoint:** `https://api.zpi.web.id/v1/music:shazam/recognize`
- **Cache TTL:** 300s

**Parameters:**

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

**cURL:**
```bash
curl -X POST "https://api.zpi.web.id/v1/music:shazam/recognize" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "audio": "clip.mp3"
}'
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:shazam/recognize", {
  method: "POST",
  headers: { "x-api-key": process.env.ZAPI_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
  "audio": "clip.mp3"
})
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.post("https://api.zpi.web.id/v1/music:shazam/recognize",
  headers={"x-api-key": "YOUR_API_KEY"},
  json={
  "audio": "clip.mp3"
})
data = r.json()
```

**Example response:**
```json
{
  "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
}
```

---

### Search

Search the catalog by text query.

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

**Parameters:**

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

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:shazam/search?q=blinding%20lights&types=songs%2Cartists&country=US&limit=10&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:shazam/search?q=blinding%20lights&types=songs%2Cartists&country=US&limit=10&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:shazam/search?q=blinding%20lights&types=songs%2Cartists&country=US&limit=10&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
    },
    {
      "url": "https://music.apple.com/us/album/blinding-lights-country-version/1735024497?i=1735024505",
      "isrc": "CALZP2400006",
      "type": "track",
      "album": "Blinding Lights (Country Version) - Single",
      "genre": "Country",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/0c/08/60/0c08603c-2eff-4dc7-4393-7cb1182bd666/198391497544.jpg/1000x1000bb.jpg",
      "title": "Blinding Lights (Country Version)",
      "artist": "Tebey",
      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview122/v4/c4/2a/51/c42a5121-3511-fbb6-27a4-702e90951103/mzaf_532872528052287412.plus.aac.ep.m4a",
      "trackId": "1735024505",
      "durationMs": 186009,
      "isExplicit": false,
      "releaseDate": "2024-03-09"
    },
    {
      "url": "https://music.apple.com/us/album/blinding-lights/1531252579?i=1531252590",
      "isrc": "USAB02001322",
      "type": "track",
      "album": "KIDZ BOP 2021",
      "genre": "Children's Music",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/a3/5f/07/a35f074c-a9cd-a148-3d05-5ec1988f6c99/20CRGIM24141.rgb.jpg/1000x1000bb.jpg",
      "title": "Blinding Lights",
      "artist": "KIDZ BOP Kids",
      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/67/de/f5/67def519-34f4-f7e9-0cb8-7f2399dff070/mzaf_3786159994825546925.plus.aac.ep.m4a",
      "trackId": "1531252590",
      "durationMs": 179247,
      "isExplicit": false,
      "releaseDate": "2020-04-17"
    },
    {
      "url": "https://music.apple.com/us/album/blinding-lights/1627610405?i=1627610546",
      "isrc": "USAT22206882",
      "type": "track",
      "album": "Blinding Lights - Single",
      "genre": "Alternative",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music112/v4/10/7a/52/107a52d6-0f4e-44c2-7f7c-1671ecd05345/075679740731.jpg/1000x1000bb.jpg",
      "title": "Blinding Lights",
      "artist": "All Time Low",
      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview112/v4/93/ae/72/93ae72e0-e138-7ad1-97d6-316e7e6c34b5/mzaf_17929181185071519993.plus.aac.ep.m4a",
      "trackId": "1627610546",
      "durationMs": 193152,
      "isExplicit": false,
      "releaseDate": "2021-07-30"
    },
    {
      "url": "https://music.apple.com/us/album/blinding-lights/1584826306?i=1584826307",
      "isrc": "DEA622100968",
      "type": "track",
      "album": "Blinding Lights - Single",
      "genre": "Pop",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/91/45/e6/9145e62e-ba62-d918-ad69-8a8f0742c122/190296456312.jpg/1000x1000bb.jpg",
      "title": "Blinding Lights",
      "artist": "Loi",
      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/f6/02/c6/f602c678-6294-6269-7f6a-0a16d2a54d5d/mzaf_10096976185372964975.plus.aac.p.m4a",
      "trackId": "1584826307",
      "durationMs": 147368,
      "isExplicit": false,
      "releaseDate": "2021-09-07"
    },
    {
      "url": "https://music.apple.com/us/album/blinding-lights-apple-music-sessions/1760204287?i=1760204542",
      "isrc": "USUG12404983",
      "type": "track",
      "album": "Apple Music Nashville Sessions",
      "genre": "Country",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/61/48/ac/6148ac57-5f56-522c-283b-320561205409/24UMGIM79424.rgb.jpg/1000x1000bb.jpg",
      "title": "Blinding Lights (Apple Music Sessions)",
      "artist": "Tyler Hubbard",
      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/4e/d1/1a/4ed11a6c-9090-7ed7-bd2c-9932b9bc49f6/mzaf_12260914930762365601.plus.aac.ep.m4a",
      "trackId": "1760204542",
      "durationMs": 210292,
      "isExplicit": false,
      "releaseDate": "2024-08-05"
    },
    {
      "url": "https://music.apple.com/us/album/blinding-lights/1499378108?i=1499378607",
      "isrc": "USUG11904206",
      "type": "track",
      "album": "After Hours",
      "genre": "R&B/Soul",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/6f/bc/e6/6fbce6c4-c38c-72d8-4fd0-66cfff32f679/20UMGIM12176.rgb.jpg/1000x1000bb.jpg",
      "title": "Blinding Lights",
      "artist": "The Weeknd",
      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/19/d6/60/19d660ff-e3a9-8377-15a3-ce4b28e89cac/mzaf_7838036723178550658.plus.aac.ep.m4a",
      "trackId": "1499378607",
      "durationMs": 200046,
      "isExplicit": false,
      "releaseDate": "2019-11-29"
    },
    {
      "url": "https://music.apple.com/us/album/blinding-lights/1556108136?i=1556108146",
      "isrc": "USUM72103027",
      "type": "track",
      "album": "Blinding Lights - Single",
      "genre": "Alternative",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/25/86/75/2586751e-538c-9a96-9d84-02d27f57cba3/21UMGIM17253.rgb.jpg/1000x1000bb.jpg",
      "title": "Blinding Lights",
      "artist": "X Ambassadors",
      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview125/v4/b9/8a/b3/b98ab32b-f373-b9da-ffce-8452e003e581/mzaf_11570117381865072744.plus.aac.ep.m4a",
      "trackId": "1556108146",
      "durationMs": 177839,
      "isExplicit": false,
      "releaseDate": "2021-03-09"
    },
    {
      "url": "https://music.apple.com/us/artist/the-weeknd/479756766",
      "name": "The Weeknd",
      "type": "artist",
      "genre": "R&B/Soul",
      "image": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/5a/56/a4/5a56a4df-e9bf-8388-3bd3-72fdb1570d18/ami-identity-777ad796f94973f081f3e54e4b81fcb1-2026-04-16T21-49-06.937Z_cropped.png/1000x1000bb.jpg",
      "artistId": "479756766"
    }
  ],
  "hasMore": true,
  "nextPage": 2
}
```

---

### Track Detail

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

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `trackId` | string | path | yes | Numeric track ID |
| `country` | string | query | no | 2-letter ISO storefront. Default: US |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:shazam/track/:trackId?country=US" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:shazam/track/:trackId?country=US", {
  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:shazam/track/:trackId?country=US",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
}
```

---

### Top Charts

Top chart tracks by country.

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

**Parameters:**

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

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/music:shazam/top?country=US&limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/music:shazam/top?country=US&limit=20", {
  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:shazam/top?country=US&limit=20",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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]"
}
```

---


_Generated: 2026-08-02T14:30:05.701Z_