Summary

Rate a show 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/show/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.

  • tvdb_id

    TVDB ID (thetvdb.com) for the show.

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

  • imdb_id (optional)

    IMDB ID for the show.

  • title

    Show title.

  • year

    Show 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",
	"tvdb_id": 213221,
	"title": "Portlandia",
	"year": 2011,
	"rating": "love"
}

Example Response

{
	"status":"success",
	"message":"rated Portlandia",
	"type":"show",
	"rating":"love",
	"ratings":{
		"percentage":50,
		"votes":4,
		"loved":2,
		"hated":2
	},
	"facebook":true,
	"twitter":true,
	"tumblr":false
}