Link Search Menu Expand Document

moment.getPlaylists

Returns personalized playlists for the user’s current moment.

Example URL

https://api.melodia.io/v1/moment.getPlaylists?userKey=a4b5G982H3r9Vf783EEd&timestamp=1625294543&activity=running&location_latitude=37.445099&location_longitude=-122.160362&location_altitude=9.1

Params

paramrequireddescriptiontype
userKeyYA unique ID to be associated with the new userString
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
timestampNCurrent moment’s Unix timestamp (in seconds). Defaults to current timestamp.Int
countNNumber of playlists to return (min=1, max=5, default=3)Int

Auth

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

Sample Response

{
    "statusCode": 200,
    "body":
        "playlists": [
            {"tracks": [
                "trackKey": "MT239432948",
                "title": "Someone Like You",
                "artist": "Adele",
                "artistKey": "MA29FE4f3gXj",
                "artwork100": "http://akamai-b.cdn.cddbp.net/cds/2.0/cover/D7E5/6608/B546/60CD_xlarge_front.jpg"
                ...
                ]
            },
            {"tracks": [
                "trackKey": "MT2894F294R",
                "title": "Thinking Out Loud",
                "artist": "Ed Sheeran",
                "artistKey": "MA69FE2f3g34",
                "artwork100": "http://akamai-b.cdn.cddbp.net/cds/2.0/cover/D7E5/6608/B546/60CD_xlarge_front.jpg"
                ...
                ]
            },
    ]
}

Discussion

Call this method to get playlist suggestions for the user’s current moment. Playlists are personalized to the user’s unique taste and are curated according to their past listening patterns. If an activity parameter is provided, the recommendation engine assumes that the user is undertaking or about to undertake in the said activity.