Summary

Rate one or more episodes on trakt. If an episode 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/episodes/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.

  • episodes

    An array of episodes to rate. Each episode object should have the following structure.

    • 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.

    • season

      Show season. Send 0 if watching a special.

    • episode

      Show episode.

    • 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",
	"episodes": [
		{
			"tvdb_id": 213221,
			"title": "Portlandia",
			"year": 2011,
			"season": 1,
			"episode": 1,
			"rating": 9
		},
		{
			"tvdb_id": 213221,
			"title": "Portlandia",
			"year": 2011,
			"season": 1,
			"episode": 2,
			"rating": 5
		}
	]
}

Example Response

{
	"status":"success",
	"message":"rated 2 episodes",
	"rated": 2,
	"unrated": 0,
	"skipped": 0,
	"skipped_episodes": []
}