CHchartmetric
Charts

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.

get/api/charts/shazam

Request

Query parameters

string required

ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

OR
'GLOBAL' required
datestring date-time

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

citystring

Shazam chart city. May return no results when country_code=GLOBAL. Use /api/charts/shazam/{country_code}/cities to list valid cities.

offsetinteger

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

latestboolean

If true, use the most recently available date and ignore date.

genre'alternative' | 'rock' | 'french-pop' | 'film-tv-and-stage' | 'randb-soul' | 'latin' | 'reggae-dancehall' | 'k-pop' | 'hip-hop-rap' | 'worldwide' | 'singer-songwriter' | 'dance' | 'afrobeats' | 'house' | 'electronic' | 'pop' | 'country' | 'regional-mexicano'

Shazam genre filter; if omitted, returns chart for all genres.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.