Get radio ranking
Get a listing of radios, ranked by a specific platform metric.
This endpoint is helpful to rank and compare radios globally, based on their nationality and their size.
Choose a platform metric, customize audience range, and get a list of songs matching these criteria.
Multiple associations availables for platform and metricType:
-
global
- reach
-
instagram
- followers
-
facebook
- fans
-
tiktok
- followers
-
twitter
- followers
-
youtube
- followers
In the response:
- "reach" is the sum of followers across the station‘s official accounts.
- "genres" are defined based on the genres of the >30s spins of the past 7 days. We list the genres that account for at least 5% of plays on the station.
- "track_age" of the radio is determined by the release dates of the songs aired over the last 7 days:
- The track age is “frontline” if over 75% of the tracks were released less than 18 months ago.
- The track age is “catalog” if less than 25% of the tracks were released more than 18 months ago.
- The track age is “mixed” if neither condition applies.
Request
GET /api/v2/top-radio/{platform}/{metricType}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| platform | string | platform code |
Required |
| metricType | string | fans, followers, reach |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| sortBy | string | total, change, percent |
Required |
| period | string | month, quarter |
Required |
| radioCountryCode | string | Radio 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 Radio response with platform followers/fan/likes/subscribres ... for a period |
Broadcast 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. |