Summary

Returns all shows in a user's watchlist. Each show will indicate when it was added to the watchlist. Protected users won't return any data unless you are friends.

URL

http://api.trakt.tv/user/watchlist/shows.format/apikey/username

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

If you send valid auth, each show will contain the watched status (boolean), number of plays (int), in watchlist (boolean), and rating (love or hate). If this user has a protected profile, valid auth will allow data to be returned for yourself and any friends.

Required Parameters

• apikey

  Sign in to view your API key.

• username

  You can get a username by browsing the website and looking at the URL when on a profile page.

Example Request

http://api.trakt.tv/user/watchlist/shows.json/apikey/justin

[
   {
      "title":"Band Of Brothers",
      "year":2001,
      "url":"http://trakt.tv/show/band-of-brothers",
      "first_aired":1000018800,
      "country":"United States",
      "overview":"Executive produced by Steven Spielberg and Tom Hanks for HBO, Band of Brothers is a ten-part miniseries based on the book Band of Brothers: E Company, 506th Regiment, 101st Airborne From Normandy to Hitler's Eagle's Nest by Steven E. Ambrose. The Series dramatically re-creates the path of Easy Company, an elite paratrooper unit, from their basic training at Camp Toccoa in Georgia in 1942, to D-Day, to their critical involvement in the Battle of the Bulge, through their triumph at the close of the war.",
      "runtime":60,
      "network":"HBO",
      "air_day":"Sunday",
      "air_time":"8:00pm",
      "certification":"TV-MA",
      "imdb_id":"tt0185906",
      "tvdb_id":"74205",
      "tvrage_id":"2708",
      "inserted":1301136469,
      "images":{
         "poster":"http://trakt.us/images/posters/304.jpg",
         "fanart":"http://trakt.us/images/fanart/304.jpg",
         "banner":"http://trakt.us/images/banners/304.jpg"
      },
      "genres":["Action","Comedy"]
   },
   {
      "title":"Being Human",
      "year":2009,
      "url":"http://trakt.tv/show/being-human",
      "first_aired":1232870400,
      "country":"United Kingdom",
      "overview":"Have you ever heard the one about a werewolf, a vampire and a ghost living together? Well for George, Mitchell and Annie, that's no joke. It's their life... or afterlife as the case may be. The supernatural trio share a rented house, desperately trying to strike a balance between their paranormal problems and the domestic challenges that regular humans take for granted. All in the hope of achieving the simple pleasure of Being Human. By forcing themselves to assimilate into society, they hope to experience the joys and satisfaction of normality...",
      "runtime":60,
      "network":"BBC Three",
      "air_day":"Sunday",
      "air_time":"9:00pm",
      "certification":"TV-MA",
      "imdb_id":"tt1349938",
      "tvdb_id":"81386",
      "tvrage_id":"0",
      "inserted":1301136499,
      "images":{
         "poster":"http://trakt.us/images/posters/892.jpg",
         "fanart":"http://trakt.us/images/fanart/892.jpg",
         "banner":"http://trakt.us/images/banners/892.jpg"
      },
      "genres":["Action","Comedy"]
   }
]