Summary

Returns a users shows airing during the time period specified. Protected users won't return any data unless you are friends.

URL

http://api.trakt.tv/user/calendar/shows.format/apikey/username/date/days

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. If you send valid auth, each show will contain rating (love or hate, false if not rated), rating_advanced (1-10, 0 if not rated), and in_watchlist (boolean). Each episode will contain watched (boolean), plays (int), in_watchlist (boolean), in_collection (boolean), rating (love or hate, false if not rated), and rating_advanced (1-10, 0 if not rated).

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.

• date (optional)

  Start date for the calendar in the format Ymd (i.e. 20110421). If blank, defaults to today.

• days (optional)

  Number of days to display starting from the date. If blank, defaults to 7 days.

Example Request

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

[
   {
      "date":"2011-04-17",
      "episodes":[
         {
            "watched":false,
            "rating":false,
            "show":{
               "title":"Breakout Kings",
               "year":2011,
               "url":"http://trakt.tv/show/breakout-kings",
               "first_aired":1299398400,
               "country":"United States",
               "overview":"From Matt Olmstead and Nick Santora, creators of the hit series \"Prison Break,\" comes \"Breakout Kings,\" a new action-packed ensemble drama following an unconventional partnership between the U.S. Marshals' office and a group of convicts as they work to catch fugitives on the run.\n\nDriven by the fact that there are few things more dangerous than a prisoner who has just escaped, and tired of following protocol and resorting to outdated methods of law enforcement, veteran U.S. Marshals Charlie Duchamp (Laz Alonso) and Ray Zancanelli (Domenick Lombardozzi) are taking an unorthodox approach to their work: using former fugitives to catch fugitives.",
               "runtime":60,
               "network":"A&E",
               "air_day":"Sunday",
               "air_time":"10:00pm",
               "certification":"TV-14",
               "imdb_id":"tt1590961",
               "tvdb_id":"219341",
               "tvrage_id":"24612",
               "images":{
                  "poster":"http://trakt.us/images/posters/6234.jpg",
                  "fanart":"http://trakt.us/images/fanart/6234.jpg",
                  "banner":"http://trakt.us/images/banners/6234.jpg"
               },
               "genres":["Action","Comedy"]
            },
            "episode":{
               "season":1,
               "number":7,
               "title":"Fun with Chemistry",
               "overview":"",
               "url":"http://trakt.tv/show/breakout-kings/season/1/episode/7",
               "first_aired":1303023600,
               "images":{
                  "screen":"http://trakt.us/images/fanart/6234-940.jpg"
               }
            }
         }
      ]
   }
}