Summary

Returns information for an episode including ratings.

URL

http://api.trakt.tv/show/episode/summary.format/apikey/title/season/episode

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

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.

• title

  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.

• season

  The season number. Use 0 if you want the specials.

• episode

  The episode number.

Example Request

http://api.trakt.tv/show/episode/summary.json/apikey/the-league/1/1

{
   "show":{
      "title":"The League",
      "year":2009,
      "url":"http://trakt.tv/show/the-league",
      "first_aired":1256799600,
      "country":"United States",
      "overview":"Set against the backdrop of a Fantasy Football league The League, created by the husband-and-wife team of Jeff Schaffer (Curb Your Enthusiasm, Seinfeld) and Jackie Marcus Schaffer (Disturbia), is a comedy about marriage, male friendship, parenting, suburbia, and growing up\u2026 or refusing to grow up.",
      "runtime":30,
      "network":"FX",
      "air_day":"Thursday",
      "air_time":"10:30pm",
      "certification":"TV-MA",
      "imdb_id":"tt1480684",
      "tvdb_id":"114701",
      "tvrage_id":"24173",
      "images":{
         "poster":"http://trakt.us/images/posters/51.jpg",
         "fanart":"http://trakt.us/images/fanart/51.jpg",
         "banner":"http://trakt.us/images/banners/51.jpg"
      },
      "ratings":{
         "percentage":94,
         "votes":36,
         "loved":34,
         "hated":2
      },
      "genres":["Action","Comedy"],
      "rating":"love",
      "in_watchlist":false
   },
   "episode":{
      "season":1,
      "number":1,
      "tvdb_id":1234,
      "title":"The Draft",
      "overview":"The League is starting up again and the guys are preparing for the big draft at Andre's downtown bachelor pad. Except Pete - the League's current champion and three time winner - who has to deal with the fact that his wife thought he wasn't going to play this year.",
      "url":"http://trakt.tv/show/the-league/season/1/episode/1",
      "first_aired":1256799600,
      "images":{
         "screen":"http://trakt.us/images/episodes/51-1-1.jpg"
      },
      "ratings":{
         "percentage":50,
         "votes":1,
         "loved":1,
         "hated":1
      },
      "watched":true,
      "plays":1,
      "rating":"love",
      "in_watchlist":false
   }
}