This method is deprecated and has been replaced by user/network/friends

Summary

Returns an array of the user's friends. Each friend has the detailed profile including what they are currently watching and their recent watches. Protected users won't return any data unless you are friends. Any friends of the main user that are protected won't display data either.

URL

http://api.trakt.tv/user/friends.format/apikey/username/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.

• extended (optional)

  Returns watched_movies and watched_episodes arrays in addition to watched. This is useful if you want the recently watched movies and episodes independently.

Example Request

http://api.trakt.tv/user/friends.json/apikey/justin

[
   {
      "username":"sean",
      "protected":false,
      "full_name":"Sean Rudford",
      "gender":"male",
      "age":29,
      "location":"Portland, OR",
      "about":"Web dev and what nots.",
      "joined":1285436965,
      "avatar":"http://trakt.us/images/avatars/2.jpg",
      "url":"http://trakt.tv/user/sean",
      "watching":{
         "type":"movie",
         "movie":{
            "title":"The Roommate",
            "year":2011,
            "released":1296806400,
            "url":"http://trakt.tv/movie/the-roommate-2011",
            "trailer":"http://www.youtube.com/watch?v=2FldQayi1FI",
            "runtime":91,
            "tagline":"2,000 colleges. 8 million roommates. Which one will you get?",
            "overview":"College student Sara finds her safety jeopardized after she's assigned to a dorm room with a new roommate, Rebecca. ",
            "certification":"R",
            "imdb_id":"tt1265990",
            "tmdb_id":"49950",
            "images":{
               "poster":"http://trakt.us/images/poster-dark.jpg",
               "fanart":"http://trakt.us/images/fanart-dark.jpg"
            }
         }
      },
      "watched":[
         {
            "type":"movie",
            "watched":1305776287,
            "movie":{
               "title":"Drive Angry",
               "year":2011,
               "released":1298620800,
               "url":"http://trakt.tv/movie/drive-angry-2011",
               "trailer":"http://www.youtube.com/watch?v=O2-hiHUh4UQ",
               "runtime":110,
               "tagline":"",
               "overview":"Drive Angry stars Nicolas Cage as Milton, a hardened felon who has broken out for one last chance at redemption. Hell bent on stopping a vicious cult of fanatics who murdered his daughter, he has three days to stop them before they sacrifice his infant granddaughter beneath a full moon. Milton must use his anger to go beyond all human limits in order to save his last connection with humanity.",
               "certification":"R",
               "imdb_id":"tt1502404",
               "tmdb_id":"47327",
               "images":{
                  "poster":"http://trakt.us/images/poster-dark.jpg",
                  "fanart":"http://trakt.us/images/fanart-dark.jpg"
               }
            }
         },
		 {
            "type":"episode",
            "watched":1305759373,
            "show":{
               "title":"The Chicago Code",
               "year":2011,
               "url":"http://trakt.tv/show/the-chicago-code",
               "imdb_id":"tt1620950",
               "tvdb_id":"164011",
               "tvrage_id":"25051",
               "first_aired":1297065600,
               "country":"United States",
               "overview":"Jarek Wysocki  is a local legend and larger-than-life veteran of the Chicago Police Department. Like the city of Chicago, Jarek is razor blades and brass knuckles wrapped in politeness and egoless charm - a man who throws away partners the way others throw away tissues. Teresa Colvin arrived at the pinnacle of the Chicago Police Department in a short period of time. She's determined to implement changes before the mud that is Chicago politics clogs her office. As a result of Teresa's difficult choices, she has made some powerful enemies along the way, including two street gangs, the police officers' union and a city alderman who proves to be a dangerous adversary.",
               "runtime":60,
               "network":"FOX",
               "air_day":"Monday",
               "air_time":"9:00pm",
               "certification":"TV-PG",
               "images":{
                  "poster":"http://trakt.us/images/poster-dark.jpg",
                  "fanart":"http://trakt.us/images/fanart-dark.jpg",
                  "banner":"http://trakt.us/images/banners/2.jpg"
               }
            },
            "episode":{
               "season":1,
               "number":12,
               "title":"Greylord & Gambat",
               "overview":"The case against Alderman Gibbons escalates when Colvin, Wysocki and Evers scramble to locate a star witness. Meanwhile, as Liam rushes to collect more evidence, he is forced to take matters into his own hands.",
               "first_aired":1305529200,
               "url":"http://trakt.tv/show/the-chicago-code/season/1/episode/12",
               "images":{
                  "screen":"http://trakt.us/images/poster-dark.jpg"
               }
            }
         }
      ]
   }
]