Link Search Menu Expand Document


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

Example URL


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


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

Sample Response

    "statusCode": 200,
        "tracks": [
            "trackKey": "MT239432948",
            "title": "Where the Streets have no name",
            "artist": "U2",
            "artistKey": "MA29FE4f3gXj",
            "artwork100": ""
            "trackKey": "MT23WMd2948",
            "title": "I'm On Fire",
            "artist": "Bruce Springsteed",
            "artistKey": "MA29FE3243gXj",
            "artwork100": ""


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