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