Summary

Get a list of all activity for your friends. The most recent 100 activities are returned for all types and actions. You can customize the activity stream with only the types and actions you need.

URL

http://api.trakt.tv/activity/friends.format/apikey/types/actions/start_ts/end_ts

Supported formats

json

Supported request methods

GET

Requires authentication

true (details)

Required Parameters

• apikey

  Sign in to view your API key.

• types (optional)

  Defaults to all, but you can instead send a comma delimited list of types. For example, the first part of the URL after the key could be /all or /movie,show or /list.
  
  Supported types:

  • episode
  • show
  • movie
  • list

• actions (optional)

  Defaults to all, but you can instead send a comma delimited list of actions. For example, the second part of the URL after the key could be /all or /watching,scrobble,seen or /rating. Make sure you set the types part of the URL to something too.
  
  Supported types:

  • watching episode, movie
  • scrobble episode, movie
  • checkin episode, movie
  • seen episode, movie
  • collection episode, movie
  • rating episode, movie, show
  • watchlist episode, movie, show
  • shout episode, movie, show
  • review episode, movie, show
  • created list
  • item_added list

• start_ts (optional)

  Specify the start timestamp in PST. Only activity from this timestamp forward will be returned. This is useful to sync up actions on a regular basis. For example, get activity over the past week only by setting the timestamp to be 1 week ago.

• end_ts (optional)

  Specify the end timestamp in PST. Only activity from this timestamp previous will be returned. This is useful to sync up actions within a specific time period.

Example Request

http://api.trakt.tv/activity/friends.json/apikey

{
   "timestamps":{
      "start":1320290123,
      "current":1320291139
   },
   "activity":[
      ...
   ]
}

The activity key is an array of activities. Each type and activity combination has different data that applies and therefore has a unique JSON object structure. Here are examples of each type and action.

See the activity/community method for the returned JSON.