Link Search Menu Expand Document

station.getSmartTracks

Returns buffer tracks for user’s smart station, ordered by dynamic matching. Also submits last played track datapoint if provided.

Example URL

https://api.melodia.io/v1/station.getSmartTracks?userKey=a4b5G982H3r9Vf783EEd&dpTrack_key=MT234jk23f&dpTrack_listenFraction=1.0&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
min_tempoNFilter recommendations to this minimum tempo (beats per minute)Int
max_tempoNFilter recommendations to this maximum tempo (beats per minute)Int
dpTrack_keyNTrack key of last played track.String
dpTrack_listenFractionNFloating number between 0.0 and 1.0 indicating what fraction of the last played track was listened before being skipped (i.e., 0.0 if immediately skipped, 1.0 if listened till end). If not provided, defaults to 1.0 if dpTrack_key is providedFloat
timestampNCurrent moment’s Unix timestamp (in seconds)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 tracks to return (defaults to 3)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 buffer your smart station with the optimal tracks.

To learn more about Melodia’s smart station, please refer to Smart Station