List Artists by Stat Range

​

Sample of artists filtered by a single metric (type) within [min, max] plus optional city / code2 / genre filters. When the query has no matches, data is the sentinel string "No artists found with given parameters." and length is -1.

Path Parameters
  • type
    Type: string enum
    required

    Stat to filter on. One of sp_followers, sp_monthly_listeners, sp_popularity, 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, youtube_daily_video_views, youtube_monthly_video_views, ws_views, soundcloud_followers, bs_followers, tiktok_followers, tiktok_likes, cm_artist_rank (e.g. cm_artist_rank, sp_followers, sp_monthly_listeners).

    values
    • sp_followers
    • sp_monthly_listeners
    • sp_popularity
    • sp_listeners_to_followers_ratio
    • sp_followers_to_listeners_ratio
Query Parameters
  • min
    Type: integer
    min:  
    0
    required

    Minimum value (inclusive) for the stat selected by type.

  • max
    Type: integer
    min:  
    0
    required

    Maximum value (inclusive) for the stat selected by type.

  • code2
    Type: string | null
    min length:  
    2
    max length:  
    2

    ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

  • genreId
    Type: integer | null

    Filter by Chartmetric genre ID.

  • subGenreId
    Type: integer | null

    Filter by Chartmetric sub-genre ID.

  • city
    Type: string

    City name filter applied to the artist top-listener city.

  • offset
    Type: integer
    min:  
    0
    max:  
    100000

    Number of entries to skip. Bounded by the public API offset limit.

  • limit
    Type: integer
    min:  
    1
    max:  
    200

    Maximum number of artists to return. Defaults to the public API default; max 200.

  • unsigned
    Type: boolean

    If true, restrict to unsigned artists. Defaults to false.

Responses
  • application/json
Request Example for get/api/artist/{type}/list
curl 'https://api.chartmetric.com/api/artist/sp_followers/list?min=0&max=0' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": 200,
    "data": [
      {
        "chartmetric_artist_id": 41457,
        "name": "Neamen Lyles",
        "code2": "US",
        "genres": "deep smooth jazz, smooth jazz, jazz",
        "cpp_rank": 375487,
        "rank_eg": 451348,
        "rank_fb": 282213,
        "spotify_popularity": 15,
        "spotify_followers": 500,
        "spotify_monthly_listeners": 3652,
        "spotify_listeners_to_followers_ratio": 7.304,
        "spotify_followers_to_listeners_ratio": 0.1369,
        "deezer_fans": "28",
        "facebook_likes": null,
        "facebook_talks": null,
        "twitter_followers": null,
        "twitter_retweets": null,
        "instagram_followers": null,
        "youtube_channel_views": null,
        "youtube_subscribers": null,
        "youtube_daily_video_views": null,
        "youtube_monthly_video_views": null,
        "wikipedia_views": null,
        "soundcloud_followers": null,
        "bandsintown_followers": null,
        "tiktok_followers": null,
        "tiktok_likes": null,
        "sp_where_people_listen": [
          {
            "code2": "id",
            "listeners": 48,
            "name": "Jakarta"
          }
        ],
        "signed": false
      }
    ]
  }
}

Success