- 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 the last 100 tv show episodes and movies a user has watched using trakt. Protected users won't return any data unless you are friends.
URL
http://api.trakt.tv/user/watched.format/apikey/username
Supported formats
json
Supported request methods
GET
Requires authentication
optional (details)
If this user has a protected profile, valid auth will allow data to be returned for yourself and any friends.
Required Parameters
-
apikey
Sign in to view your API key.
-
username
You can get a username by browsing the website and looking at the URL when on a profile page.
Example Request
http://api.trakt.tv/user/watched.json/apikey/justin
[
{
"type":"movie",
"action":"checkin",
"watched":1322213556,
"movie":{
"title":"The Girl with the Dragon Tattoo",
"year":2011,
"released":1324454400,
"url":"http://trakt.tv/movie/the-girl-with-the-dragon-tattoo-2011",
"trailer":"http://www.youtube.com/watch?v=RL8LI-h2WFc",
"runtime":0,
"tagline":"The Feel Bad Movie Of Christmas",
"overview":"Remake of the Swedish movie based on the book.",
"certification":"",
"imdb_id":"tt1568346",
"tmdb_id":"65754",
"images":{
"poster":"http://trakt.us/images/poster-dark.jpg",
"fanart":"http://trakt.us/images/fanart-dark.jpg"
},
"genres":["Action","Comedy"]
}
},
{
"type":"episode",
"action":"scrobble",
"watched":1322205384,
"show":{
"title":"Blue Mountain State",
"year":2010,
"url":"http://trakt.tv/show/blue-mountain-state",
"imdb_id":"tt1344204",
"tvdb_id":"134511",
"tvrage_id":"22667",
"first_aired":1263196800,
"country":"United States",
"overview":"It's all about football at \"Blue Mountain State\" University, but being an incoming freshman on the national championship team consists of much more than that... there's also girls, partying, hazing and of course, class.",
"runtime":30,
"network":"Spike TV",
"air_day":"Wednesday",
"air_time":"10:00pm",
"certification":"TV-MA",
"images":{
"poster":"http://trakt.us/images/posters/556.jpg",
"fanart":"http://trakt.us/images/fanart/556.jpg",
"banner":"http://trakt.us/images/banners/556.jpg"
},
"genres":["Action","Comedy"]
},
"episode":{
"season":3,
"number":3,
"title":"Thad's Back",
"overview":"Thad makes some big changes in his life after he realizes his career is in trouble. Alex acts like Thad to motivate the team. Sammy thinks he's met the perfect girl. ",
"first_aired":1317193200,
"url":"http://trakt.tv/show/blue-mountain-state/season/3/episode/3",
"images":{
"screen":"http://trakt.us/images/fanart/556-940.jpg"
}
}
}
]



