Summary

Rate a movie on trakt. Depending on the user settings, this will also send out social updates to facebook, twitter, and tumblr.

URL

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

  • 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",
	"imdb_id": "tt0082971",
	"title": "Indiana Jones and the Raiders of the Lost Ark",
	"year": 1981,
	"rating": "love"
}

Example Response

{
	"status":"success",
	"message":"rated Indiana Jones and the Raiders of the Lost Ark (1981)",
	"type":"movie",
	"rating":"love",
	"ratings":{
		"percentage":100,
		"votes":15,
		"loved":15,
		"hated":0
	},
	"facebook":true,
	"twitter":true,
	"tumblr":false
}