Summary

Add one or more items to an existing list. Items can be movies, shows, season, or episodes.

URL

http://api.trakt.tv/lists/items/add/apikey

Supported formats

json

Supported request methods

POST

Requires authentication

true (details)

Required Parameters

• apikey

  Sign in to view your API key.

• JSON POST

  • username

    trakt username.

  • password

    SHA1 hash of trakt password.

  • slug

    Slug to identify what list to add items to.

  • items

    Array of items to add to the list. Each item needs a type and enough details to identify the item being added. If an item can't be found, it will be ignored. See the example below for each type of item that can be added.

  Example JSON POST

  {
  	"username": "username",
  	"password": "sha1hash",
  	"slug": "top-10-of-2011",
  	"items": [
  		{
  			"type": "movie",
  			"imdb_id": "tt0372784",
  			"title": "Batman Begins",
  			"year": 2005
  		},
  		{
  			"type": "show",
  			"tvdb_id": "80337",
  			"title": "Mad Men"
  		},
  		{
  			"type": "season",
  			"tvdb_id": "80337",
  			"title": "Mad Men",
  			"season": 1
  		},
  		{
  			"type": "episode",
  			"tvdb_id": "80337",
  			"title": "Mad Men",
  			"season": 1,
  			"episode": 5
  		}
  	]
  }

  
  

  Example Response

  {
  	"status": "success",
  	"inserted": 4,
  	"already_exist": 0,
  	"skipped": 0,
  	"skipped_items": []
  }