Jamendo Api Documentation
GET /v3.0/charts/album
Description
Returns the trending albums chart.
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: {} | 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. |
| artistId | integer | An artist id |
| tag | string | A genre tag name |
Sample
Call:
https://api.jamendo.com/v3.0/charts/album/?client_id=your_client_id&format=jsonpretty
Response:
{
"headers":{
"status":"success",
"code":0,
"error_message":"",
"warnings":"",
"results_count":10
},
"results":[
{
"id":641166,
"type":"album",
"position":1
},
{
"id":641163,
"type":"album",
"position":2
},
{
"id":618368,
"type":"album",
"position":3
},
{
"id":617900,
"type":"album",
"position":4
},
{
"id":641326,
"type":"album",
"position":5
},
{
"id":641167,
"type":"album",
"position":6
},
{
"id":641170,
"type":"album",
"position":7
},
{
"id":622762,
"type":"album",
"position":8
},
{
"id":623769,
"type":"album",
"position":9
},
{
"id":642029,
"type":"album",
"position":10
}
]
}
