Link Search Menu Expand Document

Getting Started

Melodia offers a RESTful open new tab API, allowing you to utilize Melodia’s smart recommendation engine by calling methods that respond in JSON open new tab. Individual methods are described in the navigation panel to the left.

API BASE URL : https://api.melodia.io/v1/

As an example, to call the explore.getSimilarTracks method, the url will be structured as follows:

https://api.melodia.io/v1/explore.getSimilarTracks?trackKey=MT23432489&userKey=a4b5G982H3r9Vf783EEd

The response to the above request, which will be in JSON format, will look as such:

{
    'statusCode': 200,
    'body': {
        similarTracks: [
        {
            "trackKey": "MT239432948",
            "title": "Where the Streets have no name",
            "artist": "U2",
            "artistKey": "MA29FE4f3gXj",
            "SpotifyId": "2kzYH9XR2GOpd3uejKYidf",
            "AppleId": "794563548"
            ...
        },
        {
            "trackKey": "MT23WMd2948",
            "title": "I'm On Fire",
            "artist": "Bruce Springsteed",
            "artistKey": "MA29FE3243gXj",
            "SpotifyId": "2kzYH9XR2GOpd3uejKYidf",
            "AppleId": "794563548"
            ...
        }
    ]
    }
}

Note that all API requests must be made over HTTPS open new tab. Moreover, API requests must be authenticated, as we will describe in the next section.