List Artist Rankings by Country

​

Artist rankings within a country, filtered by area (local | foreign), type (charts | audience | growth) and subArea (local | global). The combination foreign-*-global is not supported and returns 400. The combination local-audience-global uses fan-base rank via Elasticsearch and returns a reduced field set without local_rank_trend. local_rank_trend is populated for type=audience rankings, except the local-audience-global combination.

Path Parameters
  • code2
    Type: string
    min length:  
    2
    max length:  
    2
    required

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

  • area
    Type: string enum
    required

    Whether to rank artists native to the country (local) or from outside it (foreign). One of local, foreign.

    values
    • local
    • foreign
  • type
    Type: string enum
    required

    Ranking criterion: charts (chart performance), audience (audience size), or growth (trending growth).

    values
    • charts
    • audience
    • growth
  • subArea
    required

    Ranking scope: local (within the country) or global (worldwide). When area=foreign, only local is allowed; the foreign-*-global combination returns 400.

    • enum
      const:  
      local

      Ranking scope: local (within the country) or global (worldwide). When area=foreign, only local is allowed; the foreign-*-global combination returns 400.

      values
      • local
Query Parameters
  • limit
    Type: integer
    min:  
    1
    max:  
    50

    Maximum number of items to return per request.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

Responses
  • application/json
Request Example for get/api/country/{code2}/artist-rankings/{area}/{type}/{subArea}
curl 'https://api.chartmetric.com/api/country/{code2}/artist-rankings/local/charts/local' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "id": 1093307,
      "name": "Ella Langley",
      "image_url": "https://i.scdn.co/image/ab6761610000e5ebc4670378a4188c3174ef2ca9",
      "isni": null,
      "code2": "US",
      "hometown_city": null,
      "current_city": null,
      "verified": true,
      "band": false,
      "gender": null,
      "sp_followers": 1321282,
      "sp_popularity": 86,
      "sp_monthly_listeners": 24925655,
      "deezer_fans": 14464,
      "cm_artist_rank": 121,
      "cm_artist_score": 96.39,
      "primary_genre_smart": 501131,
      "tags": [
        "country",
        "us country"
      ],
      "spotify_artist_ids": [
        "6BRxQ8cD3eqnrVj6WKDok8"
      ],
      "itunes_artist_ids": [
        1384373733
      ],
      "deezer_artist_ids": [
        "14867123"
      ],
      "amazon_artist_ids": [
        "B07D3JZFW9"
      ],
      "local_rank": 1
    },
    {
      "id": 212715,
      "name": "Morgan Wallen",
      "image_url": "https://i.scdn.co/image/ab6761610000e5eb47de0bbc22f08b5ebe14bd6e",
      "isni": "0000000467316966",
      "code2": "US",
      "hometown_city": "Knoxville",
      "current_city": "Nashville",
      "verified": false,
      "band": false,
      "gender": "male",
      "sp_followers": 15244094,
      "sp_popularity": 90,
      "sp_monthly_listeners": 33085833,
      "deezer_fans": 280609,
      "cm_artist_rank": 115,
      "cm_artist_score": 96.46,
      "primary_genre_smart": 504354,
      "tags": [
        "country pop",
        "new country",
        "country rock",
        "us country",
        "us pop"
      ],
      "spotify_artist_ids": [
        "4oUHIQIBe0LHzYfvXNW4QM"
      ],
      "itunes_artist_ids": [
        829142092
      ],
      "deezer_artist_ids": [
        "7188840"
      ],
      "amazon_artist_ids": [
        "B00QNXU7TW"
      ],
      "local_rank": 2
    }
  ]
}

Success