Jamendo Api Documentation
GET /v3.0/artists/musicinfo
Description
This method returns the tags list of each artist and its description (html) if exists.
In addition to all the get parameters in common with its parent method 'artists', musicinfo offers also the possibility to filter albums by tags (only one for the moment) through the parameter 'tag'.
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: {name, id, joindate, popularity_total, popularity_month, popularity_week} | 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. All rating orders (such as "popularity_total") follow a more specific norm: they use "desc" as default and will forcedly use "desc" even if you requested an "asc". |
| 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. |
| id | []integer | One or more artist id |
| name | string | An artist name |
| namesearch | string | Search an artist by name (artist_name matching *seachquery*) |
| hasimage | enum: {true, 1} | Return only artists with an image |
| datebetween | string | Filter on the artist joining date (the date artists joined Jamendo). This parameter need a value to be used for a between closed interval. The "from" and "to" parts are both mandatory, must be separated by an underscore ("_"), and must be both in the yyyy-mm-dd format |
| tag | string | With this parameter you can search by one tag. Unless a different order is declared, the results are returned in a relevancy order. Note that some tags (ex "guitarre") are converted to english ("guitar") or grammatically normalized before being stored and sinonimity is not supported. We therefore suggest to use an english vocabulary, or use the tracks api search whicch is way more powerful and flexible |
Sample
Call:
https://api.jamendo.com/v3.0/artists/musicinfo/?client_id=your_client_id&format=jsonpretty&name=we+are+fm
Response:
{
"headers":{
"status":"success",
"code":0,
"error_message":"",
"warnings":"",
"results_count":1
},
"results":[
{
"id":"376782",
"name":"WE ARE FM",
"website":"https:\/\/www.facebook.com\/wearefm",
"joindate":"2011-12-29",
"image":"https:\/\/usercontent.jamendo.com?type=artist&id=376782&width=300",
"shorturl":"https:\/\/jamen.do\/a\/376782",
"shareurl":"https:\/\/www.jamendo.com\/artist\/376782",
"musicinfo":{
"tags":[
"rock",
"electronic",
"energetic",
"electrorock"
],
"description":{
"en":"<p>https:\/\/www.facebook.com\/wearefm<\/p>",
"fr":"",
"es":"",
"de":"",
"pl":"",
"it":"",
"ru":"",
"pt":"",
"ja":""
}
}
}
]
}
