Summary

Get a list of all activity for a single user. 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/user.format/apikey/username/types/actions/start_ts/end_ts

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.

• 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/user.json/apikey/justin

{
   "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.