Artist
Get artists (premium)
Changed onpost/api/v2/top/artists
Request
- Base URLhttps://developers.soundcharts.com (the document declares no server; this is the origin it was published from)
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
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
Changes
- info
added the new optional
queryrequest parametercursor - info
added the optional property
/to the response with the status
- info