Discover and rank playlists by audience metrics (likes, followers, streams...) on a platform. Covers several use cases via parameters: rank by latest total audience (sortBy "total"), find fast-growing playlists (sortBy "volume" or "percent"), or find playlists within an audience range (minValue/maxValue). Filterable by country and genre.
Name
discover_playlists
Schema
Properties
| Name |
Description |
Example |
| platform |
Platform used for ranking playlists |
spotify |
| metric |
Metric used to rank playlists |
likes |
| period |
Time period used for ranking |
week |
| country |
Filter playlists by country of origin using an ISO 3166-1 alpha-2 country code. |
FR |
| genre |
Music genre used to filter playlists. |
hip hop |
| minValue |
Optional minimum audience value. Use with maxValue to find playlists whose audience falls within a range. |
0 |
| maxValue |
Optional maximum audience value. Use with minValue to find playlists whose audience falls within a range. |
|
| sortBy |
Sort playlists by latest total value, absolute growth or percentage growth |
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