Jamendo Api Documentation
GET /v3.0/playlists/hots
Description
Return Jamendo hot selection of playlists.
Required parameters
client_id
Parameter List
| Name | Type | Description |
|---|---|---|
| client_id | string | A Client Id provided by devportal.jamendo.com. |
| format | enum: {xml, json, jsonpretty} | The results formatting type |
| callback | string | Use this parameter to have the response json wrapped in a callback function (jsonp technique). Such feature is enable only for json format and GET requests; if used in combination with other formats or a not-get request, the callback parameter is simply ignored and a warning is raised |
| offset | integer | The position to start returning results from |
| limit | string | The max number of results to return. Default is 10 and Max is 200. Using the keyword 'all' still a max of 200 rows will be returned |
| order | []enum: {dateFavorite} | Sort results by the queried field(s). You can specify whether to follow an ascending or descending order adding the suffix _asc or _desc to every field (order=field_asc). Asc is the default one. |
| fullcount | boolean | Setting this parameter to true, the document header will be enriched with the 'results_fullcount' value, that is, the absolute number of rows the query would return if there was no limit and offset parameter. This value is of course very useful for pagination, but please: use it only if you really need it, as it affects performances! For this performance reasons such parameter is not available in most heavy methods. |
| audioformat | enum: {mp32} | The audio format you wish to use on the fileurl returned field. At the moment mp32 (mp3 192kbps) is the only existing format. |
Sample
Call:
https://api.jamendo.com/v3.0/playlists/hots/?client_id=your_client_id&format=jsonpretty
Response:
{
"headers":{
"status":"success",
"code":0,
"error_message":"",
"warnings":"",
"results_count":2
},
"results":[
{
"id":500162692,
"favorite":1,
"dateFavorite":1504018555,
"type":"playlist",
"userId":517707
},
{
"id":500193575,
"favorite":1,
"dateFavorite":1504020649,
"type":"playlist",
"userId":517707
}
]
}
