Artist Cached Stats & Trends

​

Cached artist stats snapshot with latest values plus weekly / monthly / bimonthly diffs and diff-percents. latest combines platform metrics (followers, listeners, playlist reach, ...) with rank fields (sp_popularity_rank, fan_base_rank, ...). weekly_diff, monthly_diff, and bimonthly_diff buckets carry only the platform metrics (no ranks). Field names are drawn from CONSTANTS.ARTIST.CM_STATS.PLATFORM / .RANK; the map is sparse (only populated for platforms where the artist has data). All values are number | null.

Path Parameters
  • id
    Type: integer
    min:  
    2
    max:  
    2147483647
    required

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
Responses
  • application/json
Request Example for get/api/artist/{id}/cmStats
curl https://api.chartmetric.com/api/artist/2/cmStats \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "timestamp": "2025-10-16T09:39:26Z",
    "latest": {
      "sp_followers": 51385645,
      "deezer_fans": 5500765,
      "sp_popularity": 88,
      "sp_monthly_listeners": 61398738,
      "ins_followers": 22894076,
      "ycs_subscribers": 17900000,
      "cm_artist_rank": 40,
      "cm_artist_rank_percentile": 1,
      "fan_base_rank": 53,
      "engagement_rank": 39,
      "artist_score": 97.58563625103979,
      "sp_popularity_rank": 22,
      "sp_followers_rank": 24,
      "sp_monthly_listeners_rank": 28
    },
    "weekly_diff": {
      "sp_followers": 164715,
      "deezer_fans": 8033,
      "sp_popularity": -1,
      "sp_monthly_listeners": 814320,
      "ins_followers": 80124
    },
    "weekly_diff_percent": {
      "sp_followers": 0.3216,
      "deezer_fans": 0.1462,
      "sp_popularity": -1.1236,
      "sp_monthly_listeners": 1.3441,
      "ins_followers": 0.3512
    },
    "monthly_diff": {
      "sp_followers": 664715,
      "sp_monthly_listeners": 2814320
    },
    "monthly_diff_percent": {
      "sp_followers": 1.31,
      "sp_monthly_listeners": 4.81
    },
    "bimonthly_diff": {
      "sp_followers": 1264715
    },
    "bimonthly_diff_percent": {
      "sp_followers": 2.56
    }
  }
}

Success