Get song ranking
Get a listing of songs, ranked by a specific platform metric
This endpoint is helpful to rank and compare songs globally, based on their performance.
Choose a platform metric, customize audience range, and get a list of songs matching these criteria.
Multiple associations availables for platform and metricType:
-
airplay
- plays
-
anghami
- plays
-
audiomack
- plays
-
boomplay
- favorites
-
gaana
- favorites
-
jiosaavn
- plays
-
line-music
- streams
-
melon
- likes
-
shazam
- count
-
soundcloud
- plays
-
spotify
- streams
- popularity
-
tiktok
- videos created
-
youtube
- views
Request
GET /api/v2/top-song/{platform}/{metricType}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| platform | string | platform code |
Required |
| metricType | string | streams, views, videos created, favorites, popularity, plays, likes, count |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| sortBy | string | total, change, percent |
Required |
| period | string | week, month, quarter |
Required |
| songCountryCode | string | Song 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 Song response with platform audience, popularity, custom ... for a period |
Song 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. |