Get Apple Music Track Charts

​

Return tracks charting on Apple Music for a given date. Supports type = top / daily / city (the last requires city_id). Entries combine chart position + historical rankStats with the track basic info. The top S3-backed chart path applies pagination after the fetch.

Query Parameters
  • genre
    Type: string

    Apple Music genre filter; restricts type to genre-specific chart types when set.

  • city_id
    Type: integer
    min:  
    0
    max:  
    2147483647

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

  • country_code

    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: string Format: date-time

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

  • type
    required

    Apple Music chart type. When genre is set, must be a genre-supported type (e.g. top); otherwise covers top / daily / city.

    • enum
      const:  
      top

      Apple Music chart type. When genre is set, must be a genre-supported type (e.g. top); otherwise covers top / daily / city.

      values
      • top
  • 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.

Responses
  • application/json
Request Example for get/api/charts/applemusic/tracks
curl 'https://api.chartmetric.com/api/charts/applemusic/tracks?type=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": 1,
    "data": [
      {
        "id": 15678739,
        "name": "Angels",
        "isrc": "USRC11700153",
        "image_url": "https://i.scdn.co/image/5026fddc",
        "cm_track": 15678739,
        "itunes": 12345,
        "rank": 5,
        "pre_rank": 7,
        "peak_rank": 1,
        "peak_date": "2024-02-01T00:00:00.000Z",
        "added_at": "2024-05-01T00:00:00.000Z",
        "chart_type": "top",
        "chart_name": "Top Tracks",
        "code2": "US",
        "country": "United States",
        "velocity": 0.1,
        "time_on_chart": "10 days",
        "rankStats": [
          {
            "rank": 5,
            "timestp": "2024-05-01T00:00:00.000Z"
          }
        ],
        "artist_names": [
          "Khalid"
        ],
        "cm_artist": [
          209693
        ],
        "itunes_artist_ids": [
          "479756766"
        ],
        "track_genre": "pop"
      }
    ]
  }
}

Success