Streaming and Downloads

Pick a random song, podcast episode or video and redirect (302) to its stream url

get/random

Query parameters

type'artist' | 'album' | 'playlist' | 'podcast_episode' | 'search' | 'song' | 'video'

Object type to pick a random item from (default: song)

filterstring

Optional parent object id to pick from (e.g. an artist, album or playlist); a smart_ prefixed id selects a smartlist

bitrateinteger

Max bitrate for transcoding in bits per second (e.g 192000 = 192Kb). Song only

formatstring

Target stream format e.g. 'mp3', 'ogg'; use 'raw' to skip transcoding. Song only

offsetinteger

Return results starting from this index position

stats0 | 1

If 0, disable stat recording when playing the object (default: 1)

Changes