Get Apple Music Album Charts

Return albums charting on Apple Music for a given date. Each entry carries album metadata joined with the chart row (rank, peak_rank, rankStats). Per-album fields vary by storefront; unknown keys are allowed.

Query Parameters

date
Type: string Format: date-time

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

If true, use the most recently available date and ignore date.
country_code
Type: string
min length:
2
max length:
2
required

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

Apple Music album-chart genre filter.
limit
Type: integer
min:
1
max:
200

Maximum number of items to return per request.
offset
Type: integer
min:
0
max:
10000

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

Responses

application/json

get/api/charts/applemusic/albums

curl 'https://api.chartmetric.com/api/charts/applemusic/albums?country_code=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": {
    "length": 1,
    "data": [
      {
        "id": 13133047,
        "name": "American Teen",
        "image_url": "https://is5-ssl.mzstatic.com/image/thumb/Music124/v4/abcd.jpeg",
        "upc": "886446326146",
        "release_date": "2017-03-03T08:00:00.000Z",
        "label": "Right Hand Music Group, LLC/RCA Records",
        "genre": "Pop",
        "rank": 3,
        "pre_rank": 5,
        "peak_rank": 1,
        "peak_date": "2017-03-10T00:00:00.000Z",
        "added_at": "2024-05-01T00:00:00.000Z",
        "country": "United States",
        "code2": "US",
        "itunes": 1208346789,
        "velocity": 0.05,
        "time_on_chart": "45 days",
        "rankStats": [
          {
            "rank": 3,
            "timestp": "2024-05-01T00:00:00.000Z"
          }
        ],
        "artist_names": [
          "Khalid"
        ],
        "cm_artist": [
          209693
        ]
      }
    ]
  }
}

Success