Artist Rank (Latest)

​

Artist's current rank within the Chartmetric artist universe for a given metric (default cm_artist_rank). Pass code2 to slice by country, genre to slice by genre. For the default cm_artist_rank metric the response uses a cached rank (overall or per-slice); other metrics compute position dynamically from cm_artist_cache. obj is null when no rank row exists.

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, 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 (Chartmetric overall artist rank).

    values
    • cm_artist_rank
    • sp_popularity
    • sp_followers
    • sp_monthly_listeners
    • sp_listeners_to_followers_ratio
  • code2
    Type: string | null
    min length:  
    2
    max length:  
    2

    Restrict to a single country (ISO 3166-1 alpha-2, e.g. 'US'). When omitted, no country filter is applied.

  • genre
    Type: integer | null

    Restrict to a single Chartmetric genre by ID. When omitted, no genre filter is applied.

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

{
  "obj": {
    "artist_rank": 1
  }
}

Success