CHchartmetric
Charts

Get Apple Music Track Charts

Return tracks charting on Apple Music for a given date. Supports type = top / daily / city; city requires city_id, and every other type requires country_code. genre applies to top only and defaults to All Genres — Apple Music's own un-segmented chart, ranked alongside the per-genre ones rather than combining them. Entries combine chart position + historical rankStats with the track basic info. The top S3-backed chart path applies pagination after the fetch.

get/api/charts/applemusic/tracks

Request

Query parameters

datestring date-time

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

type'top' | 'daily' | 'city' required

Apple Music chart type. genre applies to top only; city requires city_id instead of country_code.

genrestring

Chart genre filter. Defaults to the un-segmented 'All Genres' chart when omitted.

city_idinteger

Chartmetric city ID. Required when type=city to scope the chart to a city.

string

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

OR
'GLOBAL'
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.

Response

Success

Changes

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