- Overview
- Authentication
- Errors
- Images
- Advanced Ratings
- Scrobbling vs. Checkins
- Syncing with trakt
-
Account
-
Activity
-
Calendar
-
Comment
-
Genres
-
Lists
-
Movie
-
Movies
-
Network
-
Rate
-
Recommendations
-
Search
-
Server
-
Show
- show/cancelcheckin
- show/cancelwatching
- show/checkin
- show/comments
- show/episode/comments
- show/episode/library
- show/episode/seen
- show/episode/summary
- show/episode/unlibrary
- show/episode/unseen
- show/episode/unwatchlist
- show/episode/watchingnow
- show/episode/watchlist
- show/library
- show/related
- show/scrobble
- show/season
- show/season/library
- show/season/seen
- show/seasons
- show/seen
- show/summary
- show/unlibrary
- show/unwatchlist
- show/watching
- show/watchingnow
- show/watchlist
-
Shows
-
User
- user/calendar/shows
- user/lastactivity
- user/library/movies/all
- user/library/movies/collection
- user/library/movies/watched
- user/library/shows/all
- user/library/shows/collection
- user/library/shows/watched
- user/list
- user/lists
- user/network/followers
- user/network/following
- user/network/friends
- user/profile
- user/progress/collected
- user/progress/watched
- user/ratings/episodes
- user/ratings/movies
- user/ratings/shows
- user/watching
- user/watchlist/episodes
- user/watchlist/movies
- user/watchlist/shows
-
Deprecated
- friends/add
- friends/all
- friends/approve
- friends/delete
- friends/deny
- friends/requests
- movie/shouts
- shout/episode
- shout/movie
- shout/show
- show/episode/shouts
- show/shouts
- user/friends
- user/library/movies/hated
- user/library/movies/loved
- user/library/shows/hated
- user/library/shows/loved
- user/watched
- user/watched/episodes
- user/watched/movies
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
}
}



