Link Search Menu Expand Document

moment.getMomentTracks

Returns suggested tracks for the current moment

Example URL

https://api.melodia.io/v1/moment.getMomentTracks?userKey=a4b5G982H3r9Vf783EEd&timestamp=1625294543&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
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 for the user’s current moment. Melodia looks at the user’s past lisetening patters to find the optimal set of songs that the user is most likely to enjoy at that time and context. To request moment suggestions for a particular activity, see moment.getActivityTracks