Summary

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

URL

http://api.trakt.tv/recommendations/movies/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/movies for a list of valid genres.

  • start_year (optional)

    4 digit year to filter movies released in this year or later.

  • end_year (optional)

    4 digit year to filter movies released in this year or earlier.

  • hide_collected (optional)

    Set to true to hide any movies the user has collected.

  • hide_watchlisted (optional)

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

Example JSON POST

{
	"username": "username",
	"password": "sha1hash",
	"genre": "action",
	"hide_collected": false,
	"hide_watchlisted": true
}

Example Response

[
	{
      "title":"The Expendables",
      "year":2010,
      "released":1283410800,
      "url":"http://trakt.tv/movie/the-expendables-2010",
      "trailer":"http://youtube.com/watch?v=qgSa2tghPaA",
      "runtime":103,
      "tagline":"Choose Your Weapon.",
      "overview":"Barney Ross (Stallone) leads a band of highly skilled mercenaries including knife enthusiast Lee Christmas (Statham), a martial arts expert, heavy weapons specialist, demolitionist, and a loose-cannon sniper. When the group is commissioned by the mysterious Mr. Church to assassinate the dictator of a small South American island, Barney and Lee visit the remote locale to scout out their opposition and discover the true nature of the conflict engulfing the city.",
      "certification":"R",
      "imdb_id":"tt1320253",
      "tmdb_id":"27578",
      "images":{
         "poster":"http://trakt.us/images/posters_movies/304.jpg",
         "fanart":"http://trakt.us/images/fanart_movies/304.jpg"
      },
      "ratings":{
         "percentage":69,
         "votes":36,
         "loved":25,
         "hated":11
      },
      "genres":["Action","Comedy"]
   }
]