Summary

Returns all shows airing during the time period specified.

URL

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

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

If you send valid auth, each show will contain the 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.

• 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/calendar/shows.json/apikey

[
   {
      "date":"2011-04-16",
      "episodes":[
         {
            "show":{
               "title":"Britain's Got Talent",
               "year":2007,
               "url":"http://trakt.tv/show/britains-got-talent",
               "first_aired":1181372400,
               "country":"United Kingdom",
               "overview":"The search for the next big variety act in the UK is on with ITV's Britain's Got Talent. Popular comedians and hosts Ant and Dec join the judges Simon Cowell, Piers Morgan and Amanda Holden on this highly anticipated show that will culminate in not only a big cash prize of \u00a3100,000 for the winning act, but also a starring slot in a performance attended by Her Majesty the Queen.",
               "runtime":60,
               "network":"ITV2",
               "air_day":"",
               "air_time":"12:00am",
               "certification":"",
               "imdb_id":"tt1034201",
               "tvdb_id":"80727",
               "tvrage_id":"16137",
               "images":{
                  "poster":"http://trakt.us/images/posters/2760.jpg",
                  "fanart":"http://trakt.us/images/fanart/2760.jpg",
                  "banner":"http://trakt.us/images/banners/2760.jpg"
               },
               "genres":["Action","Comedy"]
            },
            "episode":{
               "season":5,
               "number":1,
               "title":"Episode 1",
               "overview":"",
               "url":"http://trakt.tv/show/britains-got-talent/season/5/episode/1",
               "first_aired":1302937200,
               "images":{
                  "screen":"http://trakt.us/images/fanart/2760-940.jpg"
               }
            }
         }
      ]
   }
}