SOUND.RADAR API DEV
HOME Docs

Discovery API

Shazam Charts

Recognition-led Top 200, genre, viral, and city chart snapshots for early music discovery workflows.

Overview

What this API is for

Shazam Charts captures public chart snapshots from Shazam's Top 200, genre, viral, and city chart surfaces. Coverage currently includes 71 Top 200 markets, 37 genre charts, 43 viral charts, and 124 city Top 50 charts.

Access

Public path and credentials

Basehttps://api.soundradar.co/shazam
AuthProtected data endpoints require X-API-Key. Keep issued keys server-side.
Coverage276 discovered Shazam paths, normalized into 275 crawl targets.
RefreshDaily collection at 06:17 KST through the Shazam refresh timer.

Endpoints

Available routes

GET/shazam/health

Public service health, discovery counts, and latest snapshot coverage.

GET/shazam/charts

Discovered chart catalog with Top 200, genre, viral, and city targets.

GET/shazam/top-200/{market}/latest

Latest Top 200 snapshot for a Shazam market slug.

marketrequiredlimitinclude_raw
GET/shazam/genre/{market}/{genre}/latest

Latest genre chart for a market and genre slug.

marketrequiredgenrerequiredlimit
GET/shazam/viral/{market}/latest

Latest viral chart for a supported market.

marketrequiredlimit
GET/shazam/top-50/{market}/{city}/latest

Latest city Top 50 chart where Shazam exposes a city path.

marketrequiredcityrequiredlimit
GET/shazam/snapshots

Snapshot list filtered by chart kind, market, genre, or city.

chart_kindmarketgenrecitylimit
GET/shazam/search

Search stored chart entries by artist or title.

qrequiredchart_kindmarketlimit

Examples

Request examples

curl https://api.soundradar.co/shazam/health
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/shazam/top-200/south-korea/latest?limit=10"
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/shazam/genre/world/k-pop/latest?limit=50"

Operations

Implementation notes

  • CSV-backed rows always include rank, artist, title, chart date, and snapshot metadata.
  • URL, artwork, Apple Music, and Shazam track ID fields are best-effort enrichment fields and may be null.
  • Cache partner responses for 5 to 30 minutes to avoid repeated API calls on every page view.
  • Coordinate API key changes before partner deployments.