v1

latestSwagger 2.02026-07-1493541.3 KB

Get a set of recommendations for an aggregation independent of the user's listening history

This endpoint provides a list of recent audio items associated with the aggregation along with metadata about the aggregation.

get/v2/aggregation/{aggId}/recommendations

Path parameters

aggIdinteger required

ID of an aggregation such as a program or podcast. If the specified ID is a program that publishes rundowns, the latest rundown will be returned.

Query parameters

startNuminteger

The result to start with. Allows paging through the episodes of a podcast or program, with the default, startNum=0, being the most recent episode. Ignored for programs that publish a rundown.

Headers

Authorizationstring required

Your access token from the Authorization Service. Should start with Bearer, followed by a space, followed by the token.

Response

A list of audio items from the specified aggregation

errorsobject[] required

A list of encountered errors, ignored on POST, PUT

hrefstring required

A URL representation of the resource; should generally be ignored by clients unless noted otherwise

versionstring required

The version of the Collection.Doc+JSON spec being used

All 9 operations