Summary

Returns watched progress for one or more shows.

URL

http://api.trakt.tv/user/progress/watched.format/apikey/username/title/sort/extended

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.

• title (optional)

  Defaults to all which returns every show. Otherwise, send either the slug (i.e. the-walking-dead) or TVDB ID. You can get a show's slug by browsing the website and looking at the URL when on a show summary page. You can also send a comma delimited list of titles to get progress for multiple shows.

• sort (optional)

  Defaults to title. Acceptable values are title, activity, most-completed, least-completed, recently-aired, and previously-aired.

• extended (optional)

  Return minimal show info (title, year, imdb_id, tvdb_id, tvrage_id) by default. Set to normal to also include images and show url. Set to full for the complete show details. Only get extended info if you really need to since it adds a lot of data.

Example Request

http://api.trakt.tv/user/progress/watched.json/apikey/justin/game-of-thrones,suits,74897

[
   {
      "show":{
         "title":"Game of Thrones",
         "year":2011,
         "imdb_id":"tt0944947",
         "tvdb_id":121361,
         "tvrage_id":24493
      },
      "progress":{
         "percentage":85,
         "aired":20,
         "completed":17,
         "left":3
      },
      "seasons":[
         {
            "season":1,
            "percentage":100,
            "aired":10,
            "completed":10,
            "left":0,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":true,
               "10":true
            }
         },
         {
            "season":2,
            "percentage":70,
            "aired":10,
            "completed":7,
            "left":3,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":false,
               "9":false,
               "10":false
            }
         }
      ],
      "hidden_seasons":[],
      "stats":{
         "plays":17,
         "scrobbles":16,
         "checkins":0,
         "seen":1
      },
      "next_episode":{
         "season":2,
         "num":8,
         "title":"The Prince of Winterfell"
         "first_aired":1361174400,
         "images":{
             "screen":"http://trakt.us/images/episodes/1395-2-8.10.jpg"
         }
      }
   },
   {
      "show":{
         "title":"Hell's Kitchen",
         "year":2005,
         "imdb_id":"tt0437005",
         "tvdb_id":74897,
         "tvrage_id":0
      },
      "progress":{
         "percentage":93,
         "aired":93,
         "completed":87,
         "left":6
      },
      "seasons":[
         {
            "season":4,
            "percentage":100,
            "aired":15,
            "completed":15,
            "left":0,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":true,
               "10":true,
               "11":true,
               "12":true,
               "13":true,
               "14":true,
               "15":true
            }
         },
         {
            "season":5,
            "percentage":100,
            "aired":15,
            "completed":15,
            "left":0,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":true,
               "10":true,
               "11":true,
               "12":true,
               "13":true,
               "14":true,
               "15":true
            }
         },
         {
            "season":6,
            "percentage":100,
            "aired":15,
            "completed":15,
            "left":0,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":true,
               "10":true,
               "11":true,
               "12":true,
               "13":true,
               "14":true,
               "15":true
            }
         },
         {
            "season":7,
            "percentage":100,
            "aired":15,
            "completed":15,
            "left":0,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":true,
               "10":true,
               "11":true,
               "12":true,
               "13":true,
               "14":true,
               "15":true
            }
         },
         {
            "season":8,
            "percentage":100,
            "aired":15,
            "completed":15,
            "left":0,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":true,
               "10":true,
               "11":true,
               "12":true,
               "13":true,
               "14":true,
               "15":true
            }
         },
         {
            "season":9,
            "percentage":75,
            "aired":16,
            "completed":12,
            "left":4,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":true,
               "10":true,
               "11":true,
               "12":true,
               "13":false,
               "14":false,
               "15":false,
               "16":false
            }
         },
         {
            "season":10,
            "percentage":0,
            "aired":2,
            "completed":0,
            "left":2,
            "episodes":{
               "1":false,
               "2":false
            }
         }
      ],
      "hidden_seasons":[1,2,3],
      "stats":{
         "plays":87,
         "scrobbles":24,
         "checkins":0,
         "seen":63
      },
      "next_episode":false
   },
   {
      "show":{
         "title":"Suits",
         "year":2011,
         "imdb_id":"tt1632701",
         "tvdb_id":247808,
         "tvrage_id":27518
      },
      "progress":{
         "percentage":66,
         "aired":12,
         "completed":8,
         "left":4
      },
      "seasons":[
         {
            "season":1,
            "percentage":66,
            "aired":12,
            "completed":8,
            "left":4,
            "episodes":{
               "1":true,
               "2":true,
               "3":true,
               "4":true,
               "5":true,
               "6":true,
               "7":true,
               "8":true,
               "9":false,
               "10":false,
               "11":false,
               "12":false
            }
         }
      ],
      "hidden_seasons":[],
      "stats":{
         "plays":11,
         "scrobbles":9,
         "checkins":0,
         "seen":2
      },
      "next_episode":false
   }
]