Simple vs. Advanced Ratings

By default, each user is in simple ratings mode. This mode uses the rating key (returned by all authenticated methods) and is set to love, hate, or false (not rated). In your trakt settings, you can toggle on advanced ratings mode. This mode uses the rating_advanced key and is set to 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, or 0 (not rated).

Example response

{
	"rating": "love",
	"rating_advanced": 9
}

Detecting the ratings mode

You should use account/settings to determine what mode the user is in and adjust your app accordingly.

Example response

{
	...
	"viewing":{
	      "ratings":{
	         "mode":"advanced" //simple,advanced
	      }
	}
	...
}

If you are using the activity methods, additional info is returned so you can determine what mode each user is in without needing to look up their info. Make sure to adjust your display based on the use_rating_advanced flag. If true, use the rating_advanced value to display advanced. If false, use the rating value to display simple ratings.

Example response

{
	...
	"type":"movie",
	"action":"rating",
	"rating_advanced":9,
	"use_rating_advanced":true
	...
}

Backwards compatibility

The user is free to switch between simple and advanced mode at any time without losing any data. For example, if you rated a whole bunch of movies in advanced mode, then switch to simple mode for a while, then back to advanced - all the correct data would be there. All the rate methods have been updated to accept 1-10 in addition to love and hate like before. Your existing implementations will continue to work fine until you add support for advanced ratings.

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.