Get Chartmetric Score

​

Chartmetric Score reflects the overall trend for tracks or albums, computed from weighted chart-rank positions across countries over time. Supported byType values are artist, track, album depending on chartType. Supported chartType values are spotify-top, spotify-viral, applemusic-genre, applemusic-daily, applemusic-albums, itunes, itunes_albums, shazam. Response carries two parallel views of the score timeline: overall (aggregate) and individual (per-track/per-album).

Path Parameters
  • byType
    Type: string enum
    required

    Entity kind that :id refers to (one of artist | track | album); must match the chosen chartType.

    values
    • artist
    • track
    • album
  • chartType
    Type: string enum
    required

    Chart whose Chartmetric Score is computed. One of spotify-top, spotify-viral, applemusic-genre, applemusic-daily, applemusic-albums, itunes, itunes_albums, shazam.

    values
    • spotify-top
    • spotify-viral
    • applemusic-genre
    • applemusic-daily
    • applemusic-albums
    • itunes
    • itunes_albums
    • shazam
  • id
    Type: integer
    min:  
    0
    max:  
    2147483647
    required

    Chartmetric ID for the entity in :byType (artist / track / album ID).

Query Parameters
  • since
    Type: string Format: date

    Start of the score time range (ISO date, e.g. 2025-11-01); defaults to 180 days ago.

  • until
    Type: string Format: date

    End of the score time range (ISO date, e.g. 2025-11-01); defaults to today.

Responses
  • application/json
Request Example for get/api/charts/{byType}/{id}/{chartType}/cm-score
curl https://api.chartmetric.com/api/charts/artist/0/spotify-top/cm-score \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "overall": [
      {
        "x": "2020-07-01",
        "y": 0.39,
        "count": 1,
        "details": [
          {
            "trackName": "Woke Up Late (feat. Hailee Steinfeld)",
            "trackId": 22310714,
            "details": [
              {
                "rank": 180,
                "country": "AU",
                "score": 0.39
              }
            ]
          }
        ]
      }
    ],
    "individual": [
      {
        "id": 22310714,
        "name": "Woke Up Late (feat. Hailee Steinfeld)",
        "data": [
          {
            "timestp": "2020-07-01T00:00:00.000Z",
            "score": 0.39,
            "rank_details": [
              {
                "rank": 180,
                "country": "AU",
                "score": 0.39
              }
            ]
          }
        ]
      }
    ]
  }
}

Success