Jamendo Api Documentation
GET /v3.0/charts/track
Description
Returns the trending tracks 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: {trending} | 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, one of: punk, pop, rock, electronic, hiphop, jazz, indie, soundtrack, classical, dance, chillout, ambient, folk, metal, latino, funk, rnb, reggae, country, house, emotional, energetic, romance, sad, world, blues, happy |
| country | string | Filter by artist country |
Sample
Call:
https://api.jamendo.com/v3.0/charts/track/?client_id=your_client_id&format=jsonpretty
Response:
{
"headers":{
"status":"success",
"code":0,
"error_message":"",
"warnings":"",
"results_count":10
},
"results":[
{
"id":2330946,
"artistId":"561522",
"position":1,
"type":"track"
},
{
"id":2330945,
"artistId":"561522",
"position":2,
"type":"track"
},
{
"id":2332554,
"artistId":"490580",
"position":3,
"type":"track"
},
{
"id":2330952,
"artistId":"561522",
"position":4,
"type":"track"
},
{
"id":2330949,
"artistId":"561522",
"position":5,
"type":"track"
},
{
"id":2330950,
"artistId":"561522",
"position":6,
"type":"track"
},
{
"id":2330948,
"artistId":"561522",
"position":7,
"type":"track"
},
{
"id":2330951,
"artistId":"561522",
"position":8,
"type":"track"
},
{
"id":2330944,
"artistId":"561522",
"position":9,
"type":"track"
},
{
"id":2330953,
"artistId":"561522",
"position":10,
"type":"track"
}
]
}
