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.


Explore this api

platform

platform code

metricType

streams, views, videos created, favorites, popularity, plays, likes, count

sortBy

total, change, percent

period

week, month, quarter

songCountryCode

Song 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

Try it out!