Artist Rank on Historical Date

​

Artist's rank on a specific past date (YYYY-MM-DD) for the given metric. Supported metric values: cm_artist_rank (single-row overall), cm_artist_country_rank (rows keyed by code2), cm_artist_genre_rank / cm_artist_subgenre_rank (rows keyed by {genre_id, genre}), or any other metric that flows through the stat-based COUNT fallback. Always returns an array.

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
Query Parameters
  • metric
    Type: string enum

    Rank metric to use. One of cm_artist_rank, cm_artist_country_rank, cm_artist_genre_rank, cm_artist_subgenre_rank, sp_popularity, sp_followers, sp_monthly_listeners, sp_listeners_to_followers_ratio, sp_followers_to_listeners_ratio, deezer_fans, fs_likes, fs_talks, ins_followers, ts_followers, ts_retweets, ycs_views, ycs_subscribers, ws_views, soundcloud_followers, bs_followers. Defaults to cm_artist_rank.

    values
    • cm_artist_rank
    • cm_artist_country_rank
    • cm_artist_genre_rank
    • cm_artist_subgenre_rank
    • sp_popularity
  • date
    Type: string Format: date

    Historical date in ISO format (e.g. '2025-11-01'). Defaults to today. Data may not exist for every historical date.

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

{
  "obj": [
    {
      "artist_rank": 1,
      "genre_id": 188,
      "genre": "pop"
    },
    {
      "artist_rank": 1,
      "genre_id": 419154,
      "genre": "uk pop"
    }
  ]
}

Success