Summary

Returns all episodes in a user's watchlist. Each show will have its own entry and will contain all episodes in the watchlist. Protected users won't return any data unless you are friends.

URL

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

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

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/episodes.json/apikey/justin

[
   {
      "title":"The Sopranos",
      "year":1999,
      "url":"http://trakt.tv/show/the-sopranos",
      "first_aired":915955200,
      "country":"United States",
      "overview":"Meet Tony Soprano: your average, middle-aged businessman. Tony's got a dutiful wife. A not-so-dutiful son. A daughter named Meadow. An uncle who's losing his marbles. A hot-headed nephew. A not-too-secret mistress. And a shrink to tell all his secrets, except the one she already knows: Tony's a mob boss whose troubles are wrapped up in his two families. These days, it's getting tougher and tougher to make a killing in the killing business. Just because you're \"made\" doesn't mean you've got it made.",
      "runtime":60,
      "network":"HBO",
      "air_day":"Sunday",
      "air_time":"9:00pm",
      "certification":"TV-MA",
      "imdb_id":"tt0141842",
      "tvdb_id":"75299",
      "tvrage_id":"6206",
      "images":{
         "poster":"http://trakt.us/images/posters/314.jpg",
         "fanart":"http://trakt.us/images/fanart/314.jpg",
         "banner":"http://trakt.us/images/banners/314.jpg"
      },
      "genres":["Action","Comedy"],
      "episodes":[
         {
            "season":1,
            "number":1,
            "title":"The Sopranos",
            "overview":"Tony Soprano, a Capo in the Jersey mafia, begins seeing a therapist because he is stricken by panic attacks.  During his session, Dr. Melfi learns of his two conflicted families. Tony is stressed by his unhappy wife, rebellious kids and his demanding mother. On the business side, Tony feels pressure from his willful nephew, while also engaging in a power struggle with his Uncle Junior.",
            "url":"http://trakt.tv/show/the-sopranos/season/1/episode/1",
            "first_aired":915955200,
            "inserted":1301176458,
            "images":{
               "screen":"http://trakt.us/images/posters/314-1-1.jpg"
            }
         },
         {
            "season":1,
            "number":2,
            "title":"46 Long",
            "overview":"Christopher and Brendan take some initiative in a truck hijacking, but their plan backfires when it angers Uncle Junior. Tony's crew does a favor for A.J.'s science teacher. After one too many accidents, Tony forces Livia to move into a nursing home against her will.",
            "url":"http://trakt.tv/show/the-sopranos/season/1/episode/2",
            "first_aired":916560000,
            "inserted":1301176465,
            "images":{
               "screen":"http://trakt.us/images/posters/314-1-2.jpg"
            }
         }
      ]
   }
]