Summary

Returns information for a TV show including ratings, top watchers, and most watched episodes.

URL

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

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

If you send valid auth, the summary will contain rating (love or hate, false if not rated), rating_advanced (1-10, 0 if not rated) and in_watchlist (boolean).

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.

• extended (optional)

  Returns complete season and episode info. Only send this if you really need the full dump. Use the show/seasons and show/season methods if you only need some of the season or episode info.

Example Request

http://api.trakt.tv/show/summary.json/apikey/the-walking-dead

{
   "title":"The Walking Dead",
   "year":2010,
   "url":"http://trakt.tv/show/the-walking-dead",
   "first_aired":1288508400,
   "country":"United States",
   "overview":"In the aftermath of a zombie apocalypse, a small group of survivors travel across the country in search of a new home away from the hordes. Rick Grimes, who was a police officer in the old world, leads the group. As their situation grows more and more grim, the group's desperation to survive pushes them to do almost anything to stay alive.",
   "runtime":60,
   "network":"AMC",
   "air_day":"Sunday",
   "air_time":"10:00pm",
   "certification":"TV-MA",
   "imdb_id":"tt1520211",
   "tvdb_id":153021,
   "tvrage_id":25056,
   "last_updated":1328756880,
   "images":{
      "poster":"http://trakt.us/images/posters/124.jpg",
      "fanart":"http://trakt.us/images/fanart/124.jpg",
      "banner":"http://trakt.us/images/banners/124.jpg"
   },
   "top_watchers":[
      {
         "plays":23,
         "username":"kamikaze7100",
         "protected":false,
         "full_name":null,
         "gender":null,
         "age":41,
         "location":null,
         "about":null,
         "joined":1291083256,
         "avatar":"http://trakt.us/images/avatar-large.jpg",
         "url":"http://trakt.tv/user/kamikaze7100"
      }
   ],
   "top_episodes":[
      {
         "plays":195,
         "season":1,
         "number":6,
         "title":"TS-19",
         "url":"http://trakt.tv/show/the-walking-dead/season/1/episode/6",
         "first_aired":1291536000
      }
   ],
   "ratings":{
      "percentage":97,
      "votes":739,
      "loved":717,
      "hated":22
   },
   "stats":{
      "watchers":291,
      "plays":1131,
      "scrobbles":1234,
      "checkins":10,
      "collection":22123
   },
   "people":{
      "actors":[
         {
            "name":"Andrew Lincoln",
            "character":"Rick Grimes",
            "images":{
               "headshot": "http://slurm.trakt.us/images/people/8342.jpg"
            }
         }
      ]
   },
   "genres":["Action","Comedy"],
   "rating":"love",
   "in_watchlist":false
}