Summary

Get a list of show recommendations created from your watching history and your friends. Results returned with the top recommendation first.

URL

http://api.trakt.tv/recommendations/shows/apikey

Supported formats

json

Supported request methods

POST

Requires authentication

true (details)

Required Parameters

• apikey

  Sign in to view your API key.

• JSON POST

  • username

    trakt username.

  • password

    SHA1 hash of trakt password.

  • genre (optional)

    Genre slug to filter by. See genres/shows for a list of valid genres.

  • start_year (optional)

    4 digit year to filter shows premiering in this year or later.

  • end_year (optional)

    4 digit year to filter shows premiering in this year or earlier.

  • hide_collected (optional)

    Set to true to hide any shows the user has collected at least one episode of.

  • hide_watchlisted (optional)

    Set to true to hide any shows on the user's watchlist.

Example JSON POST

{
	"username": "username",
	"password": "sha1hash"
	"genre": "science-fiction",
	"hide_collected": false,
	"hide_watchlisted": true
}

Example Response

[
	{
      "title":"Fringe",
      "year":2008,
      "url":"http://trakt.tv/show/fringe",
      "first_aired":1219734000,
      "country":"United States",
      "overview":"Fringe follows FBI Agent Olivia Dunham, Consultant Peter Bishop and science explorer extraordinaire Doctor Walter Bishop as they search for clues to the series of bizarre and horrific crimes inflicted on the world. The world that we  know. ",
      "runtime":60,
      "certification":"TV-MA",
      "imdb_id":"tt1119644",
      "tvdb_id":"82066",
      "images":{
         "poster":"http://trakt.us/images/posters/87.jpg",
         "fanart":"http://trakt.us/images/fanart/87.jpg",
         "banner":"http://trakt.us/images/banners/87.jpg"
      },
      "ratings":{
         "percentage":97,
         "votes":195,
         "loved":190,
         "hated":5
      },
      "genres":["Action","Comedy"]
   }
]