Link Search Menu Expand Document

explore.getExploreItems

Returns personalized discovery items (i.e., tracks, artists, and genres).

Example URL

https://api.melodia.io/v1/explore.getExploreItems?userKey=a4b5G982H3r9Vf783EEd

Params

paramrequireddescriptiontype
userKeyYID associated with userString

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"
                ...
            },
            ...
        ],
        "artists": [
            {
                "artistKey": "MT239432948",
                "artistName": "U2"
                ...
            },
            {
                "artistKey": "MT23WMd2948",
                "artistName": "Bruce Springsteed",
                ...
            },
            ...
        ],
        "genres": [
            {
                "genreKey": "MT239432948",
                "name": "Singer-Songwriter"
                ...
            },
            {
                "genreKey": "MT23WMd2948",
                "name": "French Rap",
                ...
            },
            ...
        ]
        }
}

Discussion

Call this method to get personalized discovery items. Note that an item can be of either track, artist, or genre.

Items are suggested to the user according to the user’s unique taste profile (i.e., liked/disliked tracks, liked artists, played/listened/skipped songs, etc.)