Summary

Returns information for a movie including ratings and top watchers.

URL

http://api.trakt.tv/movie/summary.format/apikey/title

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

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

Required Parameters

• apikey

  Sign in to view your API key.

• title

  Either the slug (i.e. the-social-network-2010), IMDB ID, or TMDB ID. You can get a movie's slug by browsing the website and looking at the URL when on a movie summary page.

Example Request

http://api.trakt.tv/movie/summary.json/apikey/tt1285016

{
   "title":"The Social Network",
   "year":2010,
   "released":1285916400,
   "url":"http://trakt.tv/movie/the-social-network-2010",
   "trailer":"http://www.youtube.com/watch?v=qgSa2tghPaA",
   "runtime":121,
   "tagline":"You don't get to 500 million friends without making a few enemies",
   "overview":"On a fall night in 2003, Harvard undergrad and computer programming genius Mark Zuckerberg sits down at his computer and heatedly begins working on a new idea. In a fury of blogging and programming, what begins in his dorm room soon becomes a global social network and a revolution in communication. A mere six years and 500 million friends later, Mark Zuckerberg is the youngest billionaire in history... but for this entrepreneur, success leads to both personal and legal complications.",
   "certification":"PG-13",
   "imdb_id":"tt1285016",
   "tmdb_id":37799,
   "rt_id":1234,
   "last_updated":1328756880,
   "images":{
      "poster":"http://trakt.us/images/posters_movies/60.jpg",
      "fanart":"http://trakt.us/images/fanart_movies/60.jpg"
   },
   "genres":["Action","Comedy"],
   "top_watchers":[
      {
         "plays":2,
         "username":"dairylee",
         "protected":false,
         "full_name":"Lee Taylor",
         "gender":"male",
         "age":23,
         "location":"Middlesbrough",
         "about":"",
         "joined":1290628171,
         "avatar":"http://trakt.us/images/avatars/446.jpg",
         "url":"http://trakt.tv/user/dairylee"
      }
   ],
   "ratings":{
      "percentage":91,
      "votes":32,
      "loved":29,
      "hated":3
   },
   "stats":{
      "watchers":65,
      "plays":73,
      "scrobbles":200,
      "checkins":20,
      "collection":1234
   },
   "people":{
      "directors":[
         {
            "name":"David Fincher",
            "images":{
               "headshot": "http://slurm.trakt.us/images/people/1413.jpg"
            }
         }
      ],
      "writers":[
         {
            "name":"Aaron Sorkin",
            "job":"Screenplay",
            "images":{
               "headshot": "http://slurm.trakt.us/images/people/1411.jpg"
            }
         }
      ],
      "producers":[
         {
            "name":"Scott Rudin",
            "executive":false,
            "images":{
               "headshot": "http://slurm.trakt.us/images/people/1403.jpg"
            }
         }
      ],
      "actors":[
         {
            "name":"Jesse Eisenberg",
            "character":"Mark Zuckerberg",
            "images":{
               "headshot": "http://slurm.trakt.us/images/people/1386.jpg"
            }
         }
      ]
   },
   "watched":true,
   "plays":3,
   "rating":"love",
   "rating_advanced":10,
   "in_watchlist":true,
   "in_collection":true
}