Summary

Get a list of all activity for one or more seasons for one or more shows. The most recent 100 activities are returned for all actions. You can customize the activity stream with only the actions you need.

URL

http://api.trakt.tv/activity/seasons.format/apikey/title/season/actions/start_ts/end_ts

Supported formats

json

Supported request methods

GET

Requires authentication

optional (details)

Required Parameters

• apikey

  Sign in to view your API key.

• title

  Either the slug (i.e. the-walking-dead) or TVDB ID. You can get a show's slug by browsing the website and looking at the URL when on a show summary page. You can also send a comma delimited list of titles to get activity for multiple shows.

• season

  The season number. Use 0 if you want the specials. You can also send a comma delimited list of seasons to get activity for multiple seasons.

• 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.
  
  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/seasons.json/apikey/the-walking-dead/1,2

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