Search for songs whose audience metrics fall within a specified range on a given platform. Use this tool to discover songs based on streaming, social media, video, or other platform-specific audience metrics.
Name
find_songs_by_audience_size
Schema
Properties
| Name |
Description |
Example |
|
platform
|
Platform used for ranking songs. Use platform "soundcharts" with metric "songScore" to retrieve the global song ranking
|
spotify
|
|
metric
|
Metric used to rank songs
|
followers
|
|
period
|
Time period used for growth ranking
|
week
|
|
artistCountry
|
Filter songs by their country of origin (artist nationality) using an ISO 3166-1 alpha-2 country code.
|
FR
|
|
genre
|
Music genre used to filter songs. Use the list_song_music_genres tool to retrieve available genres.
|
hip hop
|
|
minValue
|
Minimum audience value.
|
0
|
|
maxValue
|
Maximum audience value.
|
10000
|
|
sortBy
|
Sort songs by latest total value
|
total
|
|
sortOrder
|
Sort direction
|
desc
|
|
limit
|
Maximum number of items to return.
|
|
|
cursor
|
Pagination cursor returned by a previous call. Use it to retrieve the next page of results.
|
|
Required
| Name |
|
platform
|
|
metric
|
|
maxValue
|