Get artist ranking for a country
Get a listing of popular artists in a specific country, ranked by a specific platform metric.
This endpoint is helpful to rank and compare artists in a specific country, based on their nationality and performance.
The country chart is generated using the artist's top market ranking for each platform. Note that the artists listed are not always the most listened to in that region but rather those with this country as one of their top markets.
Choose a country and a platform metric, customize filters and audience range, and get a list of artists matching these criteria.
Multiple associations availables for platform and metricType:
-
youtube
- followers
- subscribers
-
instagram
- followers
-
tiktok
- followers
-
airplay
- plays
Request
GET /api/v2/top-artist/country/{countryCode}/{platform}/{metricType}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| platform | string | platform code |
Required |
| countryCode | string | Country code (2 letters ISO 3166-2, example: 'US', full list on https://en.wikipedia.org/wiki/ISO_3166-2) |
Required |
| metricType | string | followers, views, subscribers, plays |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| sortBy | string | total, change, percent |
Required |
| period | string | month, quarter |
Required |
| artistCountryCode | string | Artist nationality (Country code of 2 letters ISO 3166-2, example: 'US', full list on https://en.wikipedia.org/wiki/ISO_3166-2) |
|
| minValue | integer | Total audience (min value) |
|
| maxValue | integer | Total audience (max value) |
|
| minChange | integer | Change percentage audience (min value) |
|
| maxChange | integer | Change percentage audience (max value) |
|
| token | string | Page token |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A Top Artist response with platform followers/fan/likes/subscribres ... for a period |
Artist Collection |
| 401 | Unauthorized
You are not logged in |
|
| 403 | Forbidden
This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access. |