v3

latestOpenAPI 3.0.02026-07-31201304298.9 KB

Artist

Get artists (premium)

post/api/v2/top/artists

Query parameters

countryCodestring

Add a country to get artists ranked by their stats in that specific country. Avalaible values: country code of 2 letters ISO 3166-2, example: 'US', full list on https://en.wikipedia.org/wiki/ISO_3166-2. Leave empty to get the artists list based on their global stats.

cityKeystring

Add a cityKey and a countryCode to get artists ranked by their stats in that specific city. Available values are listed in the https://doc.api.soundcharts.com/api/v2/doc/reference/path/referential/get-cities-for-artist-ranking endpoint.

offsetinteger

Get results starting from position

limitinteger

Number of results (max. 500)

cursorstring

Cursor

Request body

Example request

{
  "sort": {
    "platform": "spotify",
    "metricType": "followers",
    "period": "month",
    "sortBy": "total",
    "order": "desc"
  },
  "filters": [
    {
      "type": "metric",
      "data": {
        "platform": "spotify",
        "metricType": "followers"
      }
    }
  ]
}

Response

Top artist collection response