API > Random releases

Sections: The Popyoular API allows you to randomly retrieve an album or a movie:

http://apiv2.popyoular.se/music/review-sources/collections/shared/all/random

http://apiv2.popyoular.se/music/review-sources/collections/shared/all/random/daily

http://apiv2.popyoular.se/music/review-sources/collections/shared/all/random/hourly

http://apiv2.popyoular.se/music/review-sources/collections/shared/all/random/weekly

The above calls will give you an album or movie depending on which API you're using. To get reviews you simply add url segments as described here. For example, the following gives the aggregated review for the daily random release:

http://apiv2.popyoular.se/music/review-sources/collections/shared/all/random/daily/reviews/shared/all/aggregated

If no release meeting the given criteria (see table below) could be found a 404 response will be returned

In addition to the usual paramaters controlling review output the following parameters can be used to control the random selection

Parameter Description Values
min-score The minimum collection score a release has to have to be eligible for random selection. Default value: 8
min-count The minimum number of reviews (within the collection) a release has to have to eligible for random selection. Default value: 6
mapped-by Only include releases that have been mapped [your partner name]
time Only include releases that have been reviewed in the given time period. Possible values: [week, last-week, month, last-month, days, weeks, months, years, year, last-year, all-time]
Default value: all-time
<< Events |  Maintaining Your Catalog >>