Link Search Menu Expand Document

queue.getSuggestedTracks

Returns suggested tracks for the queue

Example URL

https://api.melodia.io/v1/queue.getSuggestedTracks?userKey=a4b5G982H3r9Vf783EEd&playingTrack_key=MT1543F19k&queueTrack_keys=MT234jk23f,MTgedsfgk1bV,MT154jF291&timestamp=1625294543&activity=running&location_latitude=37.445099&location_longitude=-122.160362&location_altitude=9.1&count=5

Params

paramrequireddescriptiontype
userKeyYA unique ID to be associated with the new userString
playingTrack_keyYTrack key associated with playing trackString
queueTrack_keysNTrack keys associated with upcoming tracks in the queue (selected by the user). Track keys must be separated with a comma if more than one key is provided, and ordered according to how they appear in the queue.String
seedKeyNSeed (track, artist, or genre) key if station is seed-based radio. If no value provided, station is treated as smart stationString
timestampNCurrent moment’s Unix timestamp (in seconds). Defaults to current timestamp.Int
activityNCurrent moment’s activity. Can be either of the following: stationary, walking, running, biking, drivingString
location_latitudeNCurrent moment’s location’s latitude (in degrees)Float
location_longitudeNCurrent moment’s location’s longitude (in degrees)Float
location_altitudeNCurrent moment’s location’s altitude (in meters)Float
countNNumber of suggested tracks to return (defaults to 10)Int

Auth

This service requires authentication. Refer to Authentication for more details.

Sample Response

{
    "statusCode": 200,
    "body":
        "tracks": [
        {
            "trackKey": "MT239432948",
            "title": "Where the Streets have no name",
            "artist": "U2",
            "artistKey": "MA29FE4f3gXj",
            "artwork100": "http://akamai-b.cdn.cddbp.net/cds/2.0/cover/D7E5/6608/B546/60CD_xlarge_front.jpg"
            ...
        },
        {
            "trackKey": "MT23WMd2948",
            "title": "I'm On Fire",
            "artist": "Bruce Springsteed",
            "artistKey": "MA29FE3243gXj",
            "artwork100": "http://akamai-b.cdn.cddbp.net/cds/2.0/cover/D7E5/6608/B546/60CD_xlarge_front.jpg"
            ...
        }
    ]
}

Discussion

Call this method to get track suggestions to be added to the queue by the user. Note that these tracks are only meant as suggestions to be added by the user, and not as tracks to be buffered by the smart station. For instructions on how to get buffer tracks for the smart station, refer to station.getSmartTracks