Shazam Track Charts

Shazam track charts with country/city/genre filters. Handler switches between the city-level and genre-level SQL queries, then merges iTunes-linked track metadata and a countries_charting_count derived from a global ranking map.

Query Parameters

country_code
required

ISO 3166-1 alpha-2 country code (uppercase, e.g. 'US') or the literal 'GLOBAL' for cross-country charts.
Type: string
min length:
2
max length:
2

ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
date
Type: stringFormat: date-time

Date for the time-slice (YYYY-MM-DD). Required unless latest=true.
city
Type: string

Shazam chart city. May return no results when country_code=GLOBAL. Use /api/charts/shazam/{country_code}/cities to list valid cities.
offset
Type: integer
min:
0

Number of items to skip from the start of the result set; pair with limit to paginate.
latest
Type: boolean

If true, use the most recently available date and ignore date.
genre
Type: stringenum

Shazam genre filter; if omitted, returns chart for all genres.
values
- alternative
- rock
- french-pop
- film-tv-and-stage
- randb-soul
- latin
- reggae-dancehall
- k-pop

Responses

application/json

get/api/charts/shazam

curl 'https://api.chartmetric.com/api/charts/shazam?country_code=US&genre=alternative' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": {
    "length": null,
    "data": [
      {
        "id": 0,
        "name": null,
        "isrc": null,
        "image_url": null,
        "description": null,
        "tags": null,
        "cm_track": null,
        "cm_artist": [
          null
        ],
        "artist_names": [
          null
        ],
        "code2s": [
          null
        ],
        "artist_images": [
          null
        ],
        "artist_covers": [
          null
        ],
        "spotify_track_ids": [
          null
        ],
        "spotify_album_ids": [
          null
        ],
        "spotify_duration_ms": null,
        "itunes_track_ids": [
          null
        ],
        "itunes_album_ids": [
          null
        ],
        "itunes_artist_ids": [
          1
        ],
        "itunes_artist_names": [
          null
        ],
        "storefronts": [
          null
        ],
        "deezer_track_ids": [
          null
        ],
        "deezer_album_ids": [
          1
        ],
        "deezer_duration": null,
        "amazon_track_ids": [
          null
        ],
        "amazon_album_ids": [
          null
        ],
        "album_ids": [
          0
        ],
        "album_names": [
          null
        ],
        "album_upc": [
          null
        ],
        "album_label": [
          null
        ],
        "release_dates": [
          "2026-10-16T22:59:35.309Z"
        ],
        "created_at": "2026-10-16T22:59:35.309Z",
        "modified_at": "2026-10-16T22:59:35.309Z",
        "rank": null,
        "pre_rank": null,
        "peak_rank": null,
        "peak_date": "2026-10-16T22:59:35.309Z",
        "added_at": "2026-10-16T22:59:35.309Z",
        "velocity": null,
        "time_on_chart": "string",
        "code2": null,
        "city": null,
        "genre": null,
        "shazam_track_id": "string",
        "itunes_id": "string",
        "itunes_track_id": null,
        "itunes_album_id": [
          null
        ],
        "num_of_shazams": 1,
        "countries_charting_count": null,
        "rankStats": [
          {
            "rank": null,
            "timestp": "2026-10-16T22:59:35.309Z"
          }
        ]
      }
    ]
  }
}

Success

Get iTunes Video Charts

Shazam Chart Cities