Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 287 lines (271 sloc) 11.653 kb
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
1 # Playlist Service : get
2
3 GET playlist/get
4
5 ## Description
6
7 Get the metadata for a playlist, including tracks and subscribers.
8
9 ***
10
11 ## Requires authentication
12
13 __Requires a valid app_id__
14
15 If you wish to get a private playlist belonging to a user, a __valid user_auth_token is required__.
16
17 ***
18
19 ## Parameters
20
21 > + `app_id` - _required_ : Your Application ID (see [Application authentication](https://github.com/Qobuz/api-documentation#application-auth))
22 > + `playlist_id` - _required_ : The playlist ID to fetch the metadata of.
23 > + `extra` - _optional_ : Extra fields to include in the response (comma-separated) : `tracks`, ...
24 > + `user_auth_token` - _optional_ : The authenticated user token (see [User authentication](https://github.com/Qobuz/api-documentation#user-auth))
25
26 ***
27
28 ## Example
29 **Request**
30
31 http://www.qobuz.com/api.json/0.2/playlist/get?app_id=100000000&playlist_id=49806&extra=tracks&limit=2
32
33 **Return**
34
35 ```json
36 {
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
37 "tracks_count": 93,
38 "genres": [
39 {
40 "id": 113,
41 "percent": 45.16,
42 "color": "#5eabc1",
43 "name": "Alternatif et Indé",
44 "path": [
45 112,
46 119,
47 113
48 ],
49 "slug": "alternatif-et-inde"
50 },
51 {
52 "id": 133,
53 "percent": 16.13,
54 "color": "#5eabc1",
55 "name": "Rap",
56 "path": [
57 133
58 ],
59 "slug": "rap-hip-hop"
60 },
61 {
62 "id": 64,
63 "percent": 12.9,
64 "color": "#5eabc1",
65 "name": "Electro",
66 "path": [
67 64
68 ],
69 "slug": "electro"
70 },
71 {
72 "id": 117,
73 "percent": 7.53,
74 "color": "#5eabc1",
75 "name": "Pop",
76 "path": [
77 112,
78 117
79 ],
80 "slug": "pop"
81 }
82 ],
83 "images150": [
84 "http://static.qobuz.com/images/covers/24/55/0886443325524_150.jpg",
85 "http://static.qobuz.com/images/covers/78/22/5414939372278_150.jpg",
86 "http://static.qobuz.com/images/covers/56/51/0886443735156_150.jpg",
87 "http://static.qobuz.com/images/covers/96/46/0884501854696_150.jpg"
88 ],
89 "is_collaborative": false,
90 "images300": [
91 "http://static.qobuz.com/images/covers/24/55/0886443325524_300.jpg",
92 "http://static.qobuz.com/images/covers/78/22/5414939372278_300.jpg",
93 "http://static.qobuz.com/images/covers/56/51/0886443735156_300.jpg",
94 "http://static.qobuz.com/images/covers/96/46/0884501854696_300.jpg"
95 ],
96 "users_count": 187,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
97 "id": 49806,
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
98 "duration": 23498,
99 "updated_at": 1429899574,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
100 "is_public": true,
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
101 "description": "",
102 "name": "Electro/Rock - Best of 2013",
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
103 "owner": {
e06115c @bastienhauville Update get.md
bastienhauville authored
104 "id": 12345,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
105 "name": "loris"
106 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
107 "images": [
108 "http://static.qobuz.com/images/covers/24/55/0886443325524_50.jpg",
109 "http://static.qobuz.com/images/covers/78/22/5414939372278_50.jpg",
110 "http://static.qobuz.com/images/covers/56/51/0886443735156_50.jpg",
111 "http://static.qobuz.com/images/covers/96/46/0884501854696_50.jpg"
112 ],
113 "created_at": 1318098968,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
114 "tracks": {
115 "offset": 0,
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
116 "limit": 2,
117 "total": 93,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
118 "items": [
119 {
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
120 "id": 7343778,
121 "performers": "A$AP Rocky featuring Drake, 2 Chainz & Kendrick Lamar, Performer\r - Rakim Mayers, Composer\r - Rakim Mayers, Lyricist\r - Noah Shebib, Composer\r - Noah Shebib, Lyricist\r - Noah Shebib, Performer\r - Noah Shebib, Producer\r - Noah Shebib, Recording Engineer\r - S. Garrett, Composer\r - S. Garrett, Lyricist\r - Kyauna Clarke, Background Vocal\r - Aubrey Graham, Composer\r - Aubrey Graham, Lyricist\r - Tauheed Epps, Composer\r - Tauheed Epps, Lyricist\r - C. Papi, Producer\r - Kendrick Lamar, Composer\r - Kendrick Lamar, Lyricist\r - Luke Leveille, Assistant Engineer\r - Noel Cadastre, Assistant Engineer\r - Hector Delgado, Recording Engineer\r - Jack \"SUTHERNFOLK\" Brown, Recording Engineer\r - Finis \"KY\" White, Recording Engineer\r - Derek Ali, Recording Engineer\r - Noel Campbell, Mixing Engineer\r",
122 "duration": 233,
123 "title": "F**kin' Problems",
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
124 "album": {
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
125 "id": "0886443325524",
126 "genre": {
127 "id": 133,
128 "color": "#5eabc1",
129 "name": "Rap",
130 "path": [
131 133
132 ],
133 "slug": "rap-hip-hop"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
134 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
135 "tracks_count": 12,
136 "duration": 2951,
137 "released_at": 1357858800,
138 "title": "LONG.LIVE.A$AP",
139 "image": {
140 "thumbnail": "http://static.qobuz.com/images/covers/24/55/0886443325524_50.jpg",
141 "small": "http://static.qobuz.com/images/covers/24/55/0886443325524_230.jpg",
142 "large": "http://static.qobuz.com/images/covers/24/55/0886443325524_600.jpg"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
143 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
144 "media_count": 1,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
145 "label": {
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
146 "id": 21834,
147 "supplier_id": 23,
148 "albums_count": 11,
149 "name": "A$AP Worldwide - Polo Grounds Music - RCA Records",
150 "slug": "a-ap-worldwide-polo-grounds-music-rca-records"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
151 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
152 "artist": {
153 "picture": null,
154 "id": 694435,
155 "albums_count": 15,
156 "name": "A$AP Rocky",
157 "image": null,
158 "slug": "a-ap-rocky"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
159 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
160 "qobuz_id": 7343771,
161 "popularity": 0.261971661943,
162 "purchasable": true,
163 "streamable": false,
164 "previewable": true,
165 "sampleable": true,
166 "downloadable": true,
167 "displayable": true,
168 "purchasable_at": 1430863200,
169 "streamable_at": 1430863200,
170 "maximum_sampling_rate": 44.1,
171 "maximum_bit_depth": 16,
172 "hires": false
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
173 },
174 "performer": {
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
175 "id": 937265,
176 "name": "A$AP Rocky featuring Drake"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
177 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
178 "copyright": "(P) 2012 RCA Records, a division of Sony Music Entertainment (P) 2012 RCA Records, a division of Sony Music Entertainment",
179 "media_number": 1,
180 "track_number": 7,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
181 "version": null,
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
182 "purchasable": true,
183 "streamable": false,
184 "previewable": true,
185 "sampleable": true,
186 "downloadable": true,
187 "displayable": true,
188 "purchasable_at": 1430863200,
189 "streamable_at": 1430863200,
190 "maximum_sampling_rate": 44.1,
191 "maximum_bit_depth": 16,
192 "hires": false,
193 "position": 1,
194 "created_at": 1371573597,
195 "playlist_track_id": 18852604
196 },
197 {
198 "id": 7454606,
199 "title": "Wraith",
200 "duration": 191,
201 "performers": "Peace, Performer\r - Harrison Koisser, Composer\r - Harrison Koisser, Guitar\r - Harrison Koisser, Lyricist\r - Harrison Koisser, Vocal\r - Douglas Castle, Guitar\r - Samuel Koisser, Background Vocal\r - Samuel Koisser, Bass Guitar\r - Dominic Boyce, Background Vocal\r - Dominic Boyce, Drums\r - Jim Abbiss, Producer\r - Barny, Mixing Engineer\r - Ewan Davies, Engineer\r - Mazen Murad, Mastering Engineer\r",
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
202 "album": {
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
203 "id": "0886443735156",
204 "genre": {
205 "path": [
206 112,
207 119,
208 113
209 ],
210 "id": 113,
211 "slug": "alternatif-et-inde",
212 "color": "#5eabc1",
213 "name": "Alternatif et Indé"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
214 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
215 "tracks_count": 1,
216 "duration": 191,
217 "released_at": 1357858800,
218 "title": "Wraith",
219 "image": {
220 "small": "http://static.qobuz.com/images/covers/56/51/0886443735156_230.jpg",
221 "large": "http://static.qobuz.com/images/covers/56/51/0886443735156_600.jpg",
222 "thumbnail": "http://static.qobuz.com/images/covers/56/51/0886443735156_50.jpg"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
223 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
224 "media_count": 1,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
225 "label": {
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
226 "id": 4592,
227 "slug": "columbia",
228 "supplier_id": 23,
229 "albums_count": 13472,
230 "name": "Columbia"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
231 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
232 "artist": {
233 "id": 108478,
234 "picture": null,
235 "image": {
236 "mega": "http://userserve-ak.last.fm/serve/500/98624579/Peace+PNG.png",
237 "small": "http://userserve-ak.last.fm/serve/34s/98624579.png",
238 "medium": "http://userserve-ak.last.fm/serve/64s/98624579.png",
239 "large": "http://userserve-ak.last.fm/serve/126s/98624579.png",
240 "extralarge": "http://userserve-ak.last.fm/serve/252/98624579.png"
241 },
242 "slug": "peace",
243 "albums_count": 16,
244 "name": "Peace"
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
245 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
246 "qobuz_id": 7454605,
247 "popularity": 0.31404317417836,
248 "purchasable": true,
249 "streamable": false,
250 "previewable": true,
251 "sampleable": true,
252 "downloadable": true,
253 "displayable": true,
254 "purchasable_at": 1422572400,
255 "streamable_at": 1422572400,
256 "maximum_sampling_rate": 44.1,
257 "maximum_bit_depth": 16,
258 "hires": false
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
259 },
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
260 "performer": {
261 "id": 108478,
262 "name": "Peace"
263 },
264 "media_number": 1,
265 "copyright": "(P) 2013 Sony Music Entertainment UK Limited (P) 2013 Sony Music Entertainment UK Limited",
266 "track_number": 1,
267 "version": null,
268 "purchasable": true,
269 "streamable": false,
270 "previewable": true,
271 "sampleable": true,
272 "downloadable": true,
273 "displayable": true,
274 "purchasable_at": 1422572400,
275 "streamable_at": 1422572400,
276 "maximum_sampling_rate": 44.1,
277 "maximum_bit_depth": 16,
278 "hires": false,
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
279 "position": 2,
1b7dbbd @bastienhauville Update get.md
bastienhauville authored
280 "created_at": 1371573597,
281 "playlist_track_id": 18852606
0b50201 @tchapi Dear API, you deserve a better documentation. KR.
tchapi authored
282 }
283 ]
284 }
285 }
286 ```
Something went wrong with that request. Please try again.