Neighboring Artists

​

Artists with adjacent rankings around this artist for the requested metric. Uses cursor-based pagination around the selected artist (half before, half after). Pass type=genre to filter by the artist genre cluster — in that branch the response wraps the artist list under cluster_artists alongside tags (cluster tag list). Without type=genre the response is a bare array. Per-row stats are sparsely populated depending on the artist — contract keeps rows permissive (unknown(true)). genres is a comma-joined string of genre names.

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 neighbor by. 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.

    values
    • cm_artist_rank
    • sp_popularity
    • sp_followers
    • sp_monthly_listeners
    • sp_listeners_to_followers_ratio
  • limit
    Type: integer
    max:  
    100

    Maximum number of neighboring artists to return. Defaults to 10, max 100.

  • type
    enum
    const:  
    genre

    Set to genre to apply genre-clustering. When set, the response wraps the artist list under cluster_artists alongside tags.

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

{
  "obj": [
    {
      "id": 53722,
      "name": "Tharyk",
      "pronoun": null,
      "band": false,
      "image_url": "https://i.scdn.co/image/481216e68d8cdc2dad2ba9c64e4d9fcc98b5192a",
      "preview_url": null,
      "code2": "US",
      "cm_tag": [
        9847,
        419163
      ],
      "cm_tag_rank": [
        {
          "cm_tag": 9847,
          "rank": 1234,
          "name": "pop",
          "primary": true
        },
        {
          "cm_tag": 419163,
          "rank": 2345,
          "name": "dance pop"
        }
      ],
      "position": 117,
      "country_rank": 542,
      "country_rank_code2": "US",
      "genres": "pop, dance pop"
    }
  ]
}

Success