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 |
streams |
| 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 |