Soundcharts API - 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:

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}

Parameter name	Value	Description	Additional
platform	string	platform code	Required
metricType	string	fans, followers, reach	Required

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

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.

platform		platform code
metricType		fans, followers, reach
sortBy		total, change, percent
period		month, quarter
radioCountryCode		Radio nationality (Country code of 2 letters ISO 3166-2, example: 'US', full list on https://en.wikipedia.org/wiki/ISO_3166-2)
minValue		Total audience (min value)
maxValue		Total audience (max value)
minChange		Change percentage audience (min value)
maxChange		Change percentage audience (max value)
token		Page token