Summary

Rate one or more movies on trakt. If a movie is already rated, the rating will be replaced. This method will not sent out any social updates. This method can handle quite a bit of data input, but we'd recommend sending multiple smaller batches if you experience slow response times.

URL

http://api.trakt.tv/rate/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.

  • movies

    An array of movies to rate. Each movie object should have the following structure.

    • imdb_id

      IMDB ID for the movie.

      If you don't have the IMDB ID, you can send the TMDB ID. If you still don't have that, make sure the title and year match trakt exactly.

    • tmdb_id (optional)

      TMDB (themoviedb.org) ID for the movie.

    • title

      Movie title.

    • year

      Movie year.

    • rating

      Send love or hate for simple ratings. Send 1, 2, 3, 4, 5, 6, 7, 8, 9, or 10 for advanced ratings. You can also send unrate or 0 to undo a rating.

      If your app supports a 10 point scale, we recommend sending advanced ratings in all cases. The user can toggle between simple and advanced as they want, but this way their original 10 point ratings are always preserved.

Example JSON POST

{
	"username": "username",
	"password": "sha1hash",
	"movies": [
		{
			"imdb_id": "tt0114746",
			"title": "Twelve Monkeys",
			"year": 1995,
			"rating": 9
		},
		{
			"imdb_id": "tt0082971",
			"title": "Indiana Jones and the Raiders of the Lost Ark",
			"year": 1981,
			"rating": 10
		}
	]
}

Example Response

{
	"status":"success",
	"message":"rated 2 movies",
	"rated": 2,
	"unrated": 0,
	"skipped": 0,
	"skipped_movies": []
}