Link Search Menu Expand Document


Submit a datapoint corresponding to a played track

Example URL


userKeyYA unique ID to be associated with the new userString
dpTrack_keyYTrack key of played track.String
dpTrack_listenFractionYFloating number between 0.0 and 1.0 indicating what fraction of the recently played track was listened before being skipped. (i.e., 0.0 if immediately skipped, 1.0 if listened till end)Float
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


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

Sample Response

    'statusCode': 200,
    'body': {
       'message': "Success!"


Use this method if you just need to submit a datapoint to Melodia without needing buffered tracks in response.

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