Usuage
Summary
Returns the requested artwork for a specific artist or album
URL
- Artist API: http://api.fanart.tv/webservice/artist/apikey/musicbrainz_mbid/format/type/sort/limit/
- Album API: http://api.fanart.tv/webservice/album/apikey/musicbrainz_release-group_mbid/format/type/sort/limit/
- Record Label API: http://api.fanart.tv/webservice/label/apikey/musicbrainz_label_mbid/format/type/sort/limit/
Updates
You can now get a list of all the artists that have been updated since you last checked, you can then match this list against local artists and just update those instead of checking for every single artist
http://api.fanart.tv/webservice/newmusic/apikey/timestamp/
If you omit the timestamp then artists updated in the last 2 days will be returned, if included it must be a valid UNIX timestamp
Supported formats
- json
- php
Required Parameters
- apikey
login to view your apikey - musicbrainz_mbid
You can find an artists mbid on musicbrainz.org - musicbrainz_release-group_mbid
You can find an album (release-group) mbid on musicbrainz.org
Optional Parameters
The following parameters are optional but if you want to change any from the default value you must specify all optional parameters before the one you are changing (so if you are changing just format you don’t have to specify type, but if you want to change the sort you MUST also specify the format and type)
- format
Returns the results in the requested format
json (default) / php (returns a php serialized object) - type
Returns the requested image types
all (default) / cdart / artistbackground / albumcover / musiclogo / artistthumbs - sort
1 – Sorted by most popular image then newest(default)
2 – Sorted by newest uploaded image
3 – Sorted by oldest uploaded image - limit
Value is either 1 (1 image) or 2 (all images – default), for example, when automatically downloading images you might only want to return the first result so the user doesn’t have to provide input, whereas with a manual download you might want the user to see all the options.
Additional info
- preview
When you add the “/preview” suffix to the artwork url you get the reduced in size sample image. This causes the reduce the traffic load on the site en the example images show much faster. This is the prefered way of pre-showing images because this will not increase the download counter.http://fanart.tv/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/evanescence-4edd4c81993ef.jpg/previewImage size of preview: width=200
Example requests:
http://api.fanart.tv/webservice/artist/211215efd1b535c7dfa31fb60f15ef14/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/JSON/all/1/1/
Examples
Example JSON Response
http://api.fanart.tv/webservice/artist/211215efd1b535c7dfa31fb60f15ef14/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/json/
"Evanescence": {
"mbid_id": "f4a31f0a-51dd-4fa7-986d-3095c40c5ed9",
"artistbackground": [
{
"id": "9",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/9/evanescence-4dc719c5cc68f.jpg",
"likes": "1"
},
{
"id": "5",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/5/evanescence-4dc7197019e85.jpg",
"likes": "0"
},
{
"id": "6",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/6/evanescence-4dc7198199ccd.jpg",
"likes": "0"
},
{
"id": "7",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/7/evanescence-4dc719b1d861a.jpg",
"likes": "0"
},
{
"id": "10",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/10/evanescence-4dc71a04e1e89.jpg",
"likes": "0"
},
{
"id": "3396",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/3396/evanescence-4ddfd78af0fd3.jpg",
"likes": "0"
},
{
"id": "5475",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/5475/evanescence-4df95ca6e7111.jpg",
"likes": "0"
},
{
"id": "5476",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/5476/evanescence-4df95caedbaf5.jpg",
"likes": "0"
},
{
"id": "5477",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/5477/evanescence-4df95cb78617a.jpg",
"likes": "0"
},
{
"id": "5478",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/5478/evanescence-4df95cbf30fa0.jpg",
"likes": "0"
},
{
"id": "8588",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/8588/evanescence-4e483b0e8633f.jpg",
"likes": "0"
},
{
"id": "8589",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/8589/evanescence-4e483b19c707e.jpg",
"likes": "0"
},
{
"id": "14175",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14175/evanescence-4ec7ffe2a03c5.jpg",
"likes": "0"
},
{
"id": "14176",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14176/evanescence-4ec7fff9a70b0.jpg",
"likes": "0"
},
{
"id": "14177",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14177/evanescence-4ec80010aaaca.jpg",
"likes": "0"
},
{
"id": "14178",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14178/evanescence-4ec800228a6cd.jpg",
"likes": "0"
},
{
"id": "14179",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14179/evanescence-4ec800351536c.jpg",
"likes": "0"
},
{
"id": "14195",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14195/evanescence-4ec89451be6e6.jpg",
"likes": "0"
},
{
"id": "14196",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14196/evanescence-4ec894676162e.jpeg",
"likes": "0"
},
{
"id": "14197",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14197/evanescence-4ec894e3976de.jpg",
"likes": "0"
},
{
"id": "14198",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/artistbackground/14198/evanescence-4ec898215a517.jpg",
"likes": "0"
}
],
"musiclogo": [
{
"id": "5239",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/musiclogo/5239/evanescence-4df6263dee3c6.png",
"likes": "1"
},
{
"id": "5474",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/musiclogo/5474/evanescence-4df95bceb4b1c.png",
"likes": "1"
},
{
"id": "27702",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/musiclogo/27702/evanescence-4f8acb2ae6002.png",
"likes": "1"
}
],
"albums": {
"2187d248-1a3b-35d0-a4ec-bead586ff547": {
"albumcover": [
{
"id": "43",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/43/fallen-4dc8683fa58fe.jpg",
"likes": "0"
}
],
"cdart": [
{
"id": "17739",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/17739/fallen-4f133f8a16d25.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
},
"e7e5eaa6-baf3-3539-b163-759431597f3a": {
"albumcover": [
{
"id": "44",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/44/the-open-door-4dc868f23430d.jpg",
"likes": "0"
}
],
"cdart": [
{
"id": "11882",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/11882/the-open-door-4e837a41d0937.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
},
"ac7dd865-3c32-3bb9-9241-a4c63d940f67": {
"cdart": [
{
"id": "1874",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/1874/le-nouveau-gothique-4dd43ab8d1af6.png",
"likes": "0",
"disc": "1",
"size": "450"
}
]
},
"9ba659df-5814-32f6-b95f-02b738698e7c": {
"albumcover": [
{
"id": "3399",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/3399/anywhere-but-home-4ddfdc3ddfe8e.jpg",
"likes": "0"
}
],
"cdart": [
{
"id": "12420",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/12420/anywhere-but-home-4e9a1074d0999.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
},
"eab92048-3e05-3e0f-bc16-0780f5481b83": {
"albumcover": [
{
"id": "3400",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/3400/origin-4ddfdc3de0e2e.jpg",
"likes": "0"
}
],
"cdart": [
{
"id": "5354",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/5354/origin-4df836629a2c0.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
},
"a35bcaf6-8e4a-3087-9b3b-d1295a2d4dbb": {
"cdart": [
{
"id": "5353",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/5353/bring-me-to-life-4df8360027bb3.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
],
"albumcover": [
{
"id": "5355",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/5355/bring-me-to-life-4df8379964b33.jpg",
"likes": "0"
}
]
},
"bf18a287-fdec-3e65-b9f2-460b82790a16": {
"albumcover": [
{
"id": "5356",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/5356/not-for-your-ears-4df83799656ec.jpg",
"likes": "0"
}
]
},
"e1c522d0-2746-3845-9b1c-975632f496bc": {
"albumcover": [
{
"id": "5357",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/5357/beauty-in-darkness-b-sides-and-rarities-disc-2-4df837996c834.jpg",
"likes": "0"
}
],
"cdart": [
{
"id": "12422",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/12422/beauty-in-darkness-b-sides-and-rarities-4e9a1074d8e6a.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
},
"902331d8-67aa-3b3c-bb2a-786d6a66c823": {
"albumcover": [
{
"id": "12417",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/12417/evanescence-4e9a100d800dd.jpg",
"likes": "0"
},
{
"id": "14168",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/albumcover/14168/evanescence-4ec7fc1c16d26.jpg",
"likes": "0"
}
],
"cdart": [
{
"id": "12419",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/12419/evanescence-4e9a1074cfde2.png",
"likes": "0",
"disc": "1",
"size": "1000"
},
{
"id": "14485",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/14485/evanescence-4eceb5293c213.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
},
"8866d307-29d3-32d5-8b1b-16d8c10a85b5": {
"cdart": [
{
"id": "12418",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/12418/special-2004-4e9a1074c6589.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
},
"a23c8be0-4aa9-3f6c-b1bc-af543a1da73d": {
"cdart": [
{
"id": "12421",
"url": "http://fanart.tv/fanart/music/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/cdart/12421/ultra-rare-trax-volume-1-4e9a1074d82b2.png",
"likes": "0",
"disc": "1",
"size": "1000"
}
]
}
}
}
}
Example PHP Response
http://api.fanart.tv/webservice/artist/211215efd1b535c7dfa31fb60f15ef14/f4a31f0a-51dd-4fa7-986d-3095c40c5ed9/php/
Example code
PHP Examples
Using JSON
$art = json_decode($request);
foreach($art->musiclogos as $logo) {
echo $logo->url."
";
}
Using PHP Serialized array
$art = unserialize($request);
foreach($art["musiclogos"] as $logo) {
echo $logo["url"]."
";
}

