From dad2065044314cf8eb048882aa7b1d0aded0c2aa Mon Sep 17 00:00:00 2001 From: Patrick Griffis Date: Mon, 4 Dec 2017 14:23:03 -0500 Subject: Document more of the REST API --- rest/search.rst | 168 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 168 insertions(+) create mode 100644 rest/search.rst (limited to 'rest/search.rst') diff --git a/rest/search.rst b/rest/search.rst new file mode 100644 index 0000000..f978888 --- /dev/null +++ b/rest/search.rst @@ -0,0 +1,168 @@ +.. _rest-search: + +====== +Search +====== + +.. _rest-v1-search-getStationRecommendations: + +Get Station Recommendations +=========================== + +:Endpoint: /v1/search/getStationRecommendations + +Request +------- +.. code:: json + + {} + +Response +-------- +.. code:: json + + { + "artists": [ + { + "name": "Halsey", + "musicId": "R450147", + "pandoraId": "AR:450147", + "detailUrl": "https://www.pandora.com/artist/halsey/ARVjV9gbVJ7cjxq", + "art": [ + { + "url": "https://mediaserver-cont-sv5-2-v4v6.pandora.com/images/public/int/8/7/5/8/00602557708578_90W_90H.jpg", + "size": 90 + }, + { + "url": "https://mediaserver-cont-dc6-2-v4v6.pandora.com/images/public/int/8/7/5/8/00602557708578_130W_130H.jpg", + "size": 130 + }, + { + "url": "https://mediaserver-cont-sv5-3-v4v6.pandora.com/images/public/int/8/7/5/8/00602557708578_500W_500H.jpg", + "size": 500 + }, + { + "url": "https://mediaserver-cont-dc6-2-v4v6.pandora.com/images/public/int/8/7/5/8/00602557708578_640W_640H.jpg", + "size": 640 + }, + { + "url": "https://mediaserver-cont-ch1-2-v4v6.pandora.com/images/public/int/8/7/5/8/00602557708578_1080W_1080H.jpg", + "size": 1080 + } + ], + "likelyMatch": false, + "isComposer": false, + "isComedy": false, + "listenerCount": 2660756 + } + ], + "genreStations": [ + { + "name": "Dance Pop", + "token": "dance-pop", + "musicId": "G540", + "pandoraId": "GE:540", + "description": "Dance Pop features all the biggest hits and remixes from today's biggest stars, plus dance favorites you know and love. Check it out when you need a burst of energy!", + "art": [ + { + "url": "https://mediaserver-cont-dc6-2-v4v6.pandora.com/images/public/int/8/8/1/7/800027188_90W_90H.jpg", + "size": 90 + }, + { + "url": "https://cont-1.p-cdn.com/images/public/int/8/8/1/7/800027188_130W_130H.jpg", + "size": 130 + }, + { + "url": "https://mediaserver-cont-sv5-2-v4v6.pandora.com/images/public/int/8/8/1/7/800027188_500W_500H.jpg", + "size": 500 + }, + { + "url": "https://cont-2.p-cdn.com/images/public/int/8/8/1/7/800027188_640W_640H.jpg", + "size": 640 + }, + { + "url": "https://cont-2.p-cdn.com/images/public/int/8/8/1/7/800027188_1080W_1080H.jpg", + "size": 1080 + } + ], + "headerArt": [ + { + "url": "https://mediaserver-cont-dc6-2-v4v6.pandora.com/images/public/composite/genre_station_headers/5/4/0/genre_station_header_640x480_G540.jpg", + "size": 640 + } + ], + "listenerCount": 6810051, + "score": 100, + "isRedirect": false, + "isComedy": false, + "sampleTracks": [ + { + "musicId": "S2178312", + "pandoraId": "TR:2178312", + "songTitle": "S&M", + "albumTitle": "Loud (Explicit)", + "artistName": "Rihanna", + "artistSeoToken": "rihanna/ARZP3bqJrVgXfp4", + "artistDetailUrl": "https://www.pandora.com/artist/rihanna/ARZP3bqJrVgXfp4", + "trackSeoToken": "rihanna/loud-explicit/s-m/TRvc2f7v79JzJgK", + "trackDetailUrl": "https://www.pandora.com/artist/rihanna/loud-explicit/s-m/TRvc2f7v79JzJgK", + "albumSeoToken": "rihanna/loud-explicit/ALpt5747bcZjxX4", + "sampleUrl": "https://audio-ssl.itunes.apple.com/apple-assets-us-std-000001/Music/cd/fd/79/mzm.mewznlkh.aac.p.m4a", + "amazonUrl": "https://www.amazon.com/gp/search/?index=music&field-artist=Rihanna&field-title=Loud+%28Explicit%29&tag=wwwpandoracom-20", + "amazonDigitalAsin": "B005I0BR7C", + "albumAmazonDigitalAsin": "B005I0BR0E", + "itunesUrl": "http://itunes.apple.com/album/s-m/id417296814?i=417296825&uo=5&at=11l3Hh&app=itunes", + "trackNum": 1, + "discNum": 1, + "trackLength": 243, + "albumArt": [ + { + "url": "https://mediaserver-cont-dc6-2-v4v6.pandora.com/images/public/int/8/8/1/7/800027188_90W_90H.jpg", + "size": 90 + }, + { + "url": "https://mediaserver-cont-sv5-3-v4v6.pandora.com/images/public/int/8/8/1/7/800027188_130W_130H.jpg", + "size": 130 + }, + { + "url": "https://mediaserver-cont-sv5-1-v4v6.pandora.com/images/public/int/8/8/1/7/800027188_500W_500H.jpg", + "size": 500 + }, + { + "url": "https://mediaserver-cont-sv5-1-v4v6.pandora.com/images/public/int/8/8/1/7/800027188_640W_640H.jpg", + "size": 640 + }, + { + "url": "https://cont-1.p-cdn.com/images/public/int/8/8/1/7/800027188_1080W_1080H.jpg", + "size": 1080 + } + ] + } + ], + "sampleTracksPandoraId": "SS:18245:540", + "sampleArtists": [ + { + "musicId": "R169185", + "pandoraId": "AR:169185", + "name": "Rihanna", + "art": [ + { + "url": "https://cont-2.p-cdn.com/images/public/rovi/portrait/8/8/1/7/MN0000367188_200W.jpg", + "size": 200 + }, + { + "url": "https://mediaserver-cont-ch1-1-v4v6.pandora.com/images/public/rovi/portrait/8/8/1/7/MN0000367188_640W.jpg", + "size": 640 + }, + { + "url": "https://cont-2.p-cdn.com/images/public/rovi/portrait/8/8/1/7/MN0000367188.jpg", + "size": 1080 + } + ], + "seoToken": "rihanna/ARZP3bqJrVgXfp4", + "detailUrl": "https://www.pandora.com/artist/rihanna/ARZP3bqJrVgXfp4" + } + ] + } + ] + } \ No newline at end of file -- cgit v1.2.3