API v3

Usage

Summary

Returns the requested artwork for a specific show

If you are looking for the v2 documentation you can see it here

Endpoints

http://webservice.fanart.tv/movie/{imdb-tmdb_id}
http://webservice.fanart.tv/movie/latest

Usage

http://webservice.fanart.tv/movie/120?api_key=YOURAPIKEYHERE
http://webservice.fanart.tv/movie/latest?api_key=YOURAPIKEYHERE&date=TIMESTAMP

Using the latest endpoint

You can get a list of all the movies that have been updated since you last checked, you can then match this list against local movies and just update those instead of checking for every single movie

If you omit the timestamp then movies updated in the last 3 days will be returned, if included it must be a valid UNIX timestamp

Required Parameters

• apikey
  login to view your apikey
• imdb or tmdb id

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)

• date
  UNIX timestamp, if specified on the “latest” endpoint returns all the movies updated since timestamp
• type
  Returns the requested image types
  all (default) / movielogo / movieart/ moviedisc

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.
  [cc lang=”xml”]
  http://assets.fanart.tv/fanart/movies/120/moviedisc/101/the-lord-of-the-rings-the-fellowship-of-the-ring-4eea008189187.png/preview
  [/cc]
  Image size of preview: width=200
• textless images will be returned as 00 (that is zero zero) as the value for the lang attribute.

Example requests:

http://webservice.fanart.tv/movie/120?api_key=211215efd1b535c7dfa31fb60f15ef14
http://webservice.fanart.tv/movie/latest?api_key=211215efd1b535c7dfa31fb60f15ef14
http://webservice.fanart.tv/movie/latest?api_key=211215efd1b535c7dfa31fb60f15ef14&date=1404950400

Examples

Example JSON Response

http://webservice.fanart.tv/movie/120?api_key=211215efd1b535c7dfa31fb60f15ef14

[cc lang=”javascript”]
{
“name”: “The Lord of the Rings: The Fellowship of the Ring”,
“tmdb_id”: “120”,
“imdb_id”: “tt0120737”,
“hdmovielogo”: [
{
“id”: “50927”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-5232c108a0b11.png”,
“lang”: “en”,
“likes”: “7”
},
{
“id”: “23444”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-5110756b12ca1.png”,
“lang”: “en”,
“likes”: “4”
},
{
“id”: “19598”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-50d075ffc29d0.png”,
“lang”: “en”,
“likes”: “3”
},
{
“id”: “40057”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-51ce1aee7eae6.png”,
“lang”: “de”,
“likes”: “2”
},
{
“id”: “54181”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-525d629beab8d.png”,
“lang”: “fr”,
“likes”: “2”
},
{
“id”: “44913”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-5206b517371b3.png”,
“lang”: “fr”,
“likes”: “1”
},
{
“id”: “34631”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-5191383dcbefa.png”,
“lang”: “hu”,
“likes”: “0”
},
{
“id”: “35686”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-5199eb99bb348.png”,
“lang”: “hu”,
“likes”: “0”
}
],
“moviedisc”: [
{
“id”: “29003”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-5156389dc28f2.png”,
“lang”: “en”,
“likes”: “5”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “32371”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-517d662b253ab.png”,
“lang”: “en”,
“likes”: “3”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “57190”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-52894c3bd7c13.png”,
“lang”: “en”,
“likes”: “3”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “101”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-4eea008189187.png”,
“lang”: “en”,
“likes”: “2”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “32363”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-517d5ed2de0fa.png”,
“lang”: “fr”,
“likes”: “2”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “57191”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-52894c6503310.png”,
“lang”: “fr”,
“likes”: “2”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “57193”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-52894c86a5819.png”,
“lang”: “de”,
“likes”: “2”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “102”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-4eea017193bf6.png”,
“lang”: “en”,
“likes”: “1”,
“disc”: “2”,
“disc_type”: “bluray”
},
{
“id”: “20579”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-50e7168f2aa29.png”,
“lang”: “en”,
“likes”: “1”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “44405”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-5203895e6f6eb.png”,
“lang”: “de”,
“likes”: “1”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “44914”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-5206b54d0ab4f.png”,
“lang”: “fr”,
“likes”: “1”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “1311”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-4f71d715af530.png”,
“lang”: “es”,
“likes”: “0”,
“disc”: “1”,
“disc_type”: “dvd”
},
{
“id”: “7345”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-500c6e4240c76.png”,
“lang”: “de”,
“likes”: “0”,
“disc”: “2”,
“disc_type”: “bluray”
},
{
“id”: “7361”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-500cdde4a0487.png”,
“lang”: “de”,
“likes”: “0”,
“disc”: “1”,
“disc_type”: “bluray”
},
{
“id”: “15981”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-5072d25c79acc.png”,
“lang”: “fr”,
“likes”: “0”,
“disc”: “1”,
“disc_type”: “dvd”
},
{
“id”: “15982”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviedisc/the-lord-of-the-rings-the-fellowship-of-the-ring-5072d26f68e75.png”,
“lang”: “fr”,
“likes”: “0”,
“disc”: “1”,
“disc_type”: “bluray”
}
],
“movielogo”: [
{
“id”: “1613”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-4f78564165f48.png”,
“lang”: “en”,
“likes”: “4”
},
{
“id”: “1461”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-4f76b584b9f22.png”,
“lang”: “de”,
“likes”: “1”
},
{
“id”: “1462”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-4f76b59a2c473.png”,
“lang”: “de”,
“likes”: “1”
},
{
“id”: “5652”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-4fdf61ab6d29a.png”,
“lang”: “de”,
“likes”: “1”
},
{
“id”: “5653”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-4fdf61e931dbe.png”,
“lang”: “de”,
“likes”: “1”
},
{
“id”: “5654”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-4fdf61fc6a20b.png”,
“lang”: “de”,
“likes”: “1”
},
{
“id”: “10233”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movielogo/the-lord-of-the-rings-the-fellowship-of-the-ring-50366fc502e6d.png”,
“lang”: “fr”,
“likes”: “0”
}
],
“movieposter”: [
{
“id”: “57317”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-528aa45a8633a.jpg”,
“lang”: “en”,
“likes”: “4”
},
{
“id”: “50210”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-522af84750c20.jpg”,
“lang”: “en”,
“likes”: “2”
},
{
“id”: “52200”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-5240a87b8dca4.jpg”,
“lang”: “en”,
“likes”: “2”
},
{
“id”: “49334”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-52254ad32d427.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “50211”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-522af84751761.jpg”,
“lang”: “00”,
“likes”: “1”
},
{
“id”: “50929”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-5232c13117694.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “50939”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-5232cb4fc88ee.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “66688”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-532011ac02c71.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “66689”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-5320138325066.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “66691”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-532017bfc1ec8.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “60802”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieposter/the-lord-of-the-rings-the-fellowship-of-the-ring-52ca39328f269.jpg”,
“lang”: “en”,
“likes”: “0”
}
],
“hdmovieclearart”: [
{
“id”: “34307”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovieclearart/the-lord-of-the-rings-the-fellowship-of-the-ring-518f5ccc16a40.png”,
“lang”: “en”,
“likes”: “3”
},
{
“id”: “51006”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovieclearart/the-lord-of-the-rings-the-fellowship-of-the-ring-5233e7cc96125.png”,
“lang”: “en”,
“likes”: “3”
},
{
“id”: “45958”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovieclearart/the-lord-of-the-rings-the-fellowship-of-the-ring-520ceed2b8fe7.png”,
“lang”: “fr”,
“likes”: “1”
},
{
“id”: “45959”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovieclearart/the-lord-of-the-rings-the-fellowship-of-the-ring-520ceeeb787ec.png”,
“lang”: “fr”,
“likes”: “1”
},
{
“id”: “46177”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovieclearart/the-lord-of-the-rings-the-fellowship-of-the-ring-520e7bbce5c16.png”,
“lang”: “de”,
“likes”: “1”
},
{
“id”: “46178”,
“url”: “http://assets.fanart.tv/fanart/movies/120/hdmovieclearart/the-lord-of-the-rings-the-fellowship-of-the-ring-520e7bd8dd3b5.png”,
“lang”: “de”,
“likes”: “1”
}
],
“movieart”: [
{
“id”: “1140”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieart/the-lord-of-the-rings-the-fellowship-of-the-ring-4f6c938a134a1.png”,
“lang”: “en”,
“likes”: “2”
},
{
“id”: “1143”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieart/the-lord-of-the-rings-the-fellowship-of-the-ring-4f6c99ca75fac.png”,
“lang”: “es”,
“likes”: “1”
},
{
“id”: “1498”,
“url”: “http://assets.fanart.tv/fanart/movies/120/movieart/the-lord-of-the-rings-the-fellowship-of-the-ring-4f76f4dac9063.png”,
“lang”: “de”,
“likes”: “1”
}
],
“moviebackground”: [
{
“id”: “5299”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebackground/the-lord-of-the-rings-the-fellowship-of-the-ring-4fdb8b38d6453.jpg”,
“lang”: “en”,
“likes”: “2”
},
{
“id”: “23896”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebackground/the-lord-of-the-rings-the-fellowship-of-the-ring-5117096ac493b.jpg”,
“lang”: “en”,
“likes”: “2”
},
{
“id”: “5300”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebackground/the-lord-of-the-rings-the-fellowship-of-the-ring-4fdb8b38d794e.jpg”,
“lang”: “en”,
“likes”: “1”
}
],
“moviebanner”: [
{
“id”: “12355”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebanner/the-lord-of-the-rings-the-fellowship-of-the-ring-50485f0da465c.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “40947”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebanner/the-lord-of-the-rings-the-fellowship-of-the-ring-51d7e3fa5fb3f.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “45963”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebanner/the-lord-of-the-rings-the-fellowship-of-the-ring-520cf35ab2f25.jpg”,
“lang”: “fr”,
“likes”: “1”
},
{
“id”: “12356”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebanner/the-lord-of-the-rings-the-fellowship-of-the-ring-50485f5ae59ea.jpg”,
“lang”: “de”,
“likes”: “0”
},
{
“id”: “12357”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebanner/the-lord-of-the-rings-the-fellowship-of-the-ring-50485fa4ec10c.jpg”,
“lang”: “de”,
“likes”: “0”
},
{
“id”: “40946”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebanner/the-lord-of-the-rings-the-fellowship-of-the-ring-51d7e3ea27ea5.jpg”,
“lang”: “de”,
“likes”: “0”
},
{
“id”: “46179”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviebanner/the-lord-of-the-rings-the-fellowship-of-the-ring-520e7bf6818ef.jpg”,
“lang”: “de”,
“likes”: “0”
}
],
“moviethumb”: [
{
“id”: “40949”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviethumb/the-lord-of-the-rings-the-fellowship-of-the-ring-51d7e42a53a1d.jpg”,
“lang”: “en”,
“likes”: “1”
},
{
“id”: “40948”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviethumb/the-lord-of-the-rings-the-fellowship-of-the-ring-51d7e418803aa.jpg”,
“lang”: “de”,
“likes”: “0”
},
{
“id”: “45965”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviethumb/the-lord-of-the-rings-the-fellowship-of-the-ring-520cfa1305d6b.jpg”,
“lang”: “fr”,
“likes”: “0”
},
{
“id”: “46190”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviethumb/the-lord-of-the-rings-the-fellowship-of-the-ring-520e83ffdf8ef.jpg”,
“lang”: “de”,
“likes”: “0”
},
{
“id”: “68153”,
“url”: “http://assets.fanart.tv/fanart/movies/120/moviethumb/the-lord-of-the-rings-the-fellowship-of-the-ring-532efd41bf3ae.jpg”,
“lang”: “en”,
“likes”: “0”
}
]
}
[/cc]

Example code

PHP Examples

Using JSON
[cc lang=”php”]
$request = file_get_contents(“http://webservice.fanart.tv/movie/120?api_key=211215efd1b535c7dfa31fb60f15ef14″);
$art = json_decode($request);
foreach($art->clearlogos as $logo) {
echo $logo->url.”
“;
}
[/cc]