Play

Retrieve playlist

Method:station.getPlaylist

This method must be sent over a TLS-encrypted connection.

Name Type Description
stationToken string station token from Retrieve station list
additionalAudioUrl string Comma separated list of additional audio formats to return. (optional)
stationIsStarting boolean (optional)
includeTrackLength boolean (optional)
includeAudioToken boolean (optional)
xplatformAdCapable boolean (optional)
includeAudioReceiptUrl boolean (optional)
includeBackstageAdUrl boolean (optional)
includeSharingAdUrl boolean (optional)
includeSocialAdUrl boolean (optional)
includeCompetitiveSepIndicator boolean (optional)
includeCompletePlaylist boolean (optional)
includeTrackOptions boolean (optional)
audioAdPodCapable boolean (optional)

Valid values for additionalAudioUrl are:

  • HTTP_40_AAC_MONO
  • HTTP_64_AAC
  • HTTP_32_AACPLUS
  • HTTP_64_AACPLUS
  • HTTP_24_AACPLUS_ADTS
  • HTTP_32_AACPLUS_ADTS
  • HTTP_64_AACPLUS_ADTS
  • HTTP_128_MP3
  • HTTP_32_WMA

Usually a playlist contains four tracks.

{
     "userAuthToken": "XXX",
     "additionalAudioUrl":  "HTTP_32_AACPLUS_ADTS,HTTP_64_AACPLUS_ADTS",
     "syncTime": 1335841463,
     "stationToken": "121193154444133035"
}
Name Type Description
items.additionalAudioUrl array/string List of additional audio urls in the requested order or single string if only one format was requested
items.songRating int 1 if song was given a thumbs up, 0 if song was not rated yet
items.audioUrlMap object Song audio format and bitrates returned differ based on what partner credentials are used.
{
     "stat": "ok",
     "result": {
         "items": [{
             "trackToken": "40b892bc5376e695c2e5c2b347227b85af2761b6aa417f736d9a79319b8f4cb97c9695a5f9a9a32aa2abaed43571235c",
             "artistName": "Cannabich, Christian",
             "albumName": "London Mozart Players, Christian Cannabich: Symphonies",
             "amazonAlbumUrl": "http://www.amazon.com/dp/B000GW8ATU/?tag=wwwpandoracom-20",
             "songExplorerUrl": "http://www.pandora.com/xml/music/song/london-mozart-players/christian-cannabich-symphonies/2-andantino?explicit=false",
             "albumArtUrl": "http://cont-sv5-2.pandora.com/images/public/amz/5/2/9/7/095115137925_500W_488H.jpg",
             "artistDetailUrl": "http://www.pandora.com/christian-cannabich?...",
             "audioUrlMap": {
                 "highQuality": {
                     "bitrate": "64",
                     "encoding": "aacplus",
                     "audioUrl": "http://audio-sjl-t1-2.pandora.com/access/166132182435087962.mp4?...",
                     "protocol": "http"
                 },
                 "mediumQuality": {
                     "bitrate": "64",
                     "encoding": "aacplus",
                     "audioUrl": "http://t1-2.cdn.pandora.com/access/4127124196771074419.mp4?...",
                     "protocol": "http"
                 },
                 "lowQuality": {
                     "bitrate": "32",
                     "encoding": "aacplus",
                     "audioUrl": "http://audio-sv5-t1-1.pandora.com/access/3464788359714661029.mp4?...",
                     "protocol": "http"
                 }
             },
             "itunesSongUrl": "http://click.linksynergy.com/fs-bin/stat?...",
             "additionalAudioUrl": [
                 "http://t1-2.cdn.pandora.com/access/6705986462049243054.mp4?...",
                 "http://audio-sjl-t1-1.pandora.com/access/2473529637452270302.mp4?..."
             ],
             "amazonAlbumAsin": "B000GW8ATU",
             "amazonAlbumDigitalAsin": "B003H37NN4",
             "artistExplorerUrl": "http://www.pandora.com/xml/music/composer/christian-cannabich?explicit=false",
             "songName": "Symphony In G Major",
             "albumDetailUrl": "http://www.pandora.com/london-mozart-players/christian-cannabich-symphonies?...",
             "songDetailUrl": "http://www.pandora.com/london-mozart-players/christian-cannabich-symphonies/2-andantino?...",
             "stationId": "121193154444133035",
             "songRating": 0,
             "trackGain": "10.09",
             "albumExplorerUrl": "http://www.pandora.com/xml/music/album/london-mozart-players/christian-cannabich-symphonies?explicit=false",
             "allowFeedback": true,
             "amazonSongDigitalAsin": "B003H39AGW",
             "nowPlayingStationAdUrl": "http://ad.doubleclick.net/pfadx/pand.android/prod.nowplaying..."
         }, {
             "adToken": "121193154444133035-none"
         },
         ]
     }
}

Rate track

Method:station.addFeedback

Songs can be “loved” or “banned”. Both influence the music played on the station. Banned songs are never played again on this particular station.

Name Type Description
stationToken string  
trackToken string  
isPositive boolean false bans track
{
    "stationToken": "374145764047334893",
    "trackToken": "fcc2298ec4b1c93e73ad4b2813ceca0dba565bbbe03d8a78bad65ee89a7aaf4d0b3b11954fe6ab08794283f8ef1d44bfc32ce9f8e0513bec",
    "isPositive": false,
    "userAuthToken": "XXX",
    "syncTime": 1404911036
}
Name Type Description
dateCreated object  
musicToken string  
songName string  
totalThumbsUp int  
feedbackId string See Remove feedback
isPositive boolean  
{
    "stat": "ok",
    "result": {
        "totalThumbsDown": 4,
        "stationPersonalizationPercent": 57,
        "dateCreated": {
            "date": 9,
            "day": 3,
            "hours": 6,
            "minutes": 3,
            "month": 6,
            "seconds": 56,
            "time": 1404911036840,
            "timezoneOffset": 420,
            "year": 114
        },
        "albumArtUrl": "http://cont-sv5-2.pandora.com/images/public/amz/2/2/9/5/094632175922_130W_130H.jpg",
        "musicToken": "23234b0abdbeb37d",
        "songName": "Nothing Compares 2 U",
        "artistName": "Sinead O'Connor",
        "totalThumbsUp": 20,
        "feedbackId": "21955050420286614",
        "isPositive": false
    }
}

Temporarily ban track

Method:user.sleepSong

A song can be banned from all stations temporarily (one month).

Name Type Description
trackToken string See Retrieve playlist
{
    "trackToken": "d6aa37c60833f12150c4e2ba172c46f24590ebc49df948b6fb7117314c41c8e7d4faee3568884468d9509db2ab998dafdbc4093baf8c38ef",
    "userAuthToken": "XXX",
    "syncTime": 1336386838
}

Nothing is returned in the response.

Explain track choice

Method:track.explainTrack

Get (incomplete) list of attributes assigned to song by Music Genome Project.

Name Type Description
trackToken string See Retrieve playlist
{
    "trackToken": "94f36e09e341780c2ee7ebbb3581a55c4f2066dbaa60f2ee253ede5bc407fbd3c4f6db7ed00f92312437e020e0bf0e05d2924742c2ccece2",
    "userAuthToken": "XXX",
    "syncTime": 1336675993
}

The request returns a list of attributes. Note that the last item is not an actual attribute.

Name Type Description
explanations array  
{
    "stat": "ok",
    "result": {
        "explanations": [{
            "focusTraitName": "trance roots",
            "focusTraitId": "F7524"
        },
        {
            "focusTraitName": "many other similarities identified in the Music Genome Project",
            "focusTraitId": "F4797"
        }]
    }
}