Reading taste profiles

This tutorial shows how to read data that is in a taste profile

Details

A taste profile contains information on music items such as songs or artists. You can use the catalog/read method to get detailed information about each item in the taste profile.

Example

In this example, we read information about each of the items in an artist profile. We can read information on up to 100 items at a time. As usual the 'start' and 'results' parameter will allow us to page through all of the results in the profile.

Response

{
    "response": {
        "catalog": {
            "id": "CARGIFF12C029024EF", 
            "items": [
                {
                    "date_added": "2010-10-31T13:57:29", 
                    "item_id": "", 
                    "play_count": 7187
                }, 
                {
                    "artist_id": "ARV3CRH1187B9A1B21", 
                    "artist_name": "Green Day", 
                    "date_added": "2010-10-31T13:57:29", 
                    "foreign_id": "CARGIFF12C029024EF:artist:Green Day", 
                    "play_count": 1, 
                    "request": {
                        "artist_name": "Green Day", 
                        "item_id": "Green Day"
                    }
                }, 
                {
                    "artist_id": "ARF2EHS1187B994F4E", 
                    "artist_name": "Kings of Leon", 
                    "date_added": "2010-10-31T13:57:29", 
                    "foreign_id": "CARGIFF12C029024EF:artist:Kings Of Leon", 
                    "play_count": 18, 
                    "request": {
                        "artist_name": "Kings Of Leon", 
                        "item_id": "Kings Of Leon"
                    }
                }, 
                {
                    "artist_id": "ARKU3Z61187FB51DCA", 
                    "artist_name": "Rihanna", 
                    "date_added": "2010-10-31T13:57:29", 
                    "foreign_id": "CARGIFF12C029024EF:artist:Rihanna", 
                    "play_count": 368, 
                    "request": {
                        "artist_name": "Rihanna", 
                        "item_id": "Rihanna"
                    }
                }, 
                {
                    "artist_id": "ARTH9041187FB43E1F", 
                    "artist_name": "Eminem", 
                    "date_added": "2010-10-31T13:57:29", 
                    "foreign_id": "CARGIFF12C029024EF:artist:Eminem", 
                    "play_count": 155, 
                    "request": {
                        "artist_name": "Eminem", 
                        "item_id": "Eminem"
                    }
                }
            ], 
            "name": "Artist catalog for WHTZ", 
            "start": 0, 
            "total": 134, 
            "type": "artist"
        }, 
        "status": {
            "code": 0, 
            "message": "Success", 
            "version": "4.2"
        }
    }
}
For each resolved item, the read method will return the item id, name, the date the item was added to the profile, the foreign id of the item, along with any usage information about that item (play count, skip count, etc.). Also included in the response is a request block which includes information that was used to originally resolve the item. You can request additional information be returned for each item by specifying the type of additional information via the bucket parameter. For instance, you can retrieve the hotttnesss and familiarity for each artist in an artist profile like so:

Response

{
    "response": {
        "catalog": {
            "id": "CARGIFF12C029024EF", 
            "items": [
                {
                    "date_added": "2010-10-31T13:57:29", 
                    "item_id": "", 
                    "play_count": 7187
                }, 
                {
                    "artist_id": "ARV3CRH1187B9A1B21", 
                    "artist_name": "Green Day", 
                    "date_added": "2010-10-31T13:57:29", 
                    "familiarity": 0.89302047214332803, 
                    "foreign_id": "CARGIFF12C029024EF:artist:Green Day", 
                    "hotttnesss": 0.66897630229135618, 
                    "play_count": 1, 
                    "request": {
                        "artist_name": "Green Day", 
                        "item_id": "Green Day"
                    }
                }, 
                {
                    "artist_id": "ARF2EHS1187B994F4E", 
                    "artist_name": "Kings of Leon", 
                    "date_added": "2010-10-31T13:57:29", 
                    "familiarity": 0.85507530610211901, 
                    "foreign_id": "CARGIFF12C029024EF:artist:Kings Of Leon", 
                    "hotttnesss": 0.53405008933520948, 
                    "play_count": 18, 
                    "request": {
                        "artist_name": "Kings Of Leon", 
                        "item_id": "Kings Of Leon"
                    }
                }, 
                {
                    "artist_id": "ARKU3Z61187FB51DCA", 
                    "artist_name": "Rihanna", 
                    "date_added": "2010-10-31T13:57:29", 
                    "familiarity": 0.89052586692028823, 
                    "foreign_id": "CARGIFF12C029024EF:artist:Rihanna", 
                    "hotttnesss": 0.87407454844522492, 
                    "play_count": 368, 
                    "request": {
                        "artist_name": "Rihanna", 
                        "item_id": "Rihanna"
                    }
                }
            ], 
            "name": "Artist catalog for WHTZ", 
            "start": 0, 
            "total": 134, 
            "type": "artist"
        }, 
        "status": {
            "code": 0, 
            "message": "Success", 
            "version": "4.2"
        }
    }
}