This method requires a developer API key with scrobble permissions.

Summary

Notify trakt that a user has started watching a movie.

URL

http://api.trakt.tv/movie/watching/apikey

Supported formats

json

Supported request methods

POST

Requires authentication

true (details)

Required Parameters

• apikey

  Requires a developer API key. Details here.

• JSON POST

  • username

    trakt username.

  • password

    SHA1 hash of trakt password.

  • imdb_id

    IMDB ID for the movie

    If you don't have the IMDB ID, you can send the TMDB ID. If you still don't have that, make sure the title and year match trakt exactly.

  • tmdb_id (optional)

    TMDB (themoviedb.org) ID for the movie.

  • title

    Movie title.

  • year

    Movie year.

  • duration

    Duration in minutes.

  • progress

    % progress, integer 0-100. It is recommended to call the watching API every 15 minutes, then call the scrobble API near the end of the movie to lock it in.

  • plugin_version

    Internal version of your plugin. Make sure to increment this for each plugin update. Used to help debug your plugin.

  • media_center_version

    Version number of the media center, be as specific as you can including nightly build number, etc. Used to help debug your plugin.

  • media_center_date

    Build date of the media center. Used to help debug your plugin.

Example JSON POST

{
	"username": "username",
	"password": "sha1hash",
	"imdb_id": "tt0372784",
	"title": "Batman Begins",
	"year": 2005,
	"duration": 141,
	"progress": 25,
	"plugin_version": "1.0",
	"media_center_version": "10.0",
	"media_center_date": "Dec 17 2010"
}

Example Response

{
	"status": "success",
	"message": "watching Batman Begins (2005)"
}