Get artist ranking for a city
Get a listing of popular artists in a specific city, ranked by a specific platform metric.
This endpoint is helpful to rank and compare artists in a specific city, based on their nationality, and performance.
The city chart is generated using the artist's top city ranking for each platform. Note that the artists listed are not always the most listened to in that region but rather those with this city as one of their top markets.
Choose a city and a platform metric, customize filters and audience range, and get a list of artists matching these criteria.
To find the cityKey, use the Get cities for artist ranking endpoint.
Multiple associations availables for platform and metricType:
-
spotify
- monthly_listeners
-
youtube
- views
-
instagram
- followers
Request
GET /api/v2/top-artist/city/{cityKey}/{platform}/{metricType}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| platform | string | platform code |
Required |
| metricType | string | followers, views, monthly_listeners |
Required |
| cityKey | string | city key |
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. |