Summary

Returns all movies a user has rated. By default all rated movies are returned, but you can also limit to a specific rating. Protected users won't return any data unless you are friends.

URL

http://api.trakt.tv/user/ratings/movies.format/apikey/username/rating/extended

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

If this user has a protected profile, valid auth will allow data to be returned for yourself and any friends.

Required Parameters

• apikey

  Sign in to view your API key.

• username

  You can get a username by browsing the website and looking at the URL when on a profile page.

• rating (optional)

  By default, this assume all ratings will be returned. For simple ratings, use love or hate. For advanced ratings use 1, 2, 3, 4, 5, 6, 7, 8, 9, or 10. Note that love and 10 are the same and hate and 1 are the same.

• extended (optional)

  By default, this returns the minimal info. Set to normal for more info (url, images, genres). Set to full for full info. Only send this if you really need the full dump as it doubles the data size being sent back.

Example Request

http://api.trakt.tv/user/ratings/movies.json/apikey/justin/all

[
   {
      "inserted":1310108607,
      "rating":"love",
      "rating_advanced":10,
      "title":"12 Monkeys",
      "year":1995,
      "imdb_id":"tt0114746",
      "tmdb_id":"63"
   },
   {
      "inserted":1317711501,
      "rating":"love",
      "rating_advanced":10,
      "title":"30 Days of Night",
      "year":2007,
      "imdb_id":"tt0389722",
      "tmdb_id":"4513"
   }
]