A Pythonic interface to the Trakt.tv REST API
Python Makefile
Clone or download
Latest commit 037b9bf Feb 25, 2018



Travis CI Status Code Health Downloads License

This module is designed to be a Pythonic interface to the Trakt.tv. REST API. The official documentation for which can be found here. trakt contains interfaces to all of the Trakt.tv functionality in an, ideally, easily scriptable fashion. For more information on this module's contents and example usages please see the PyTrakt docs.

More information about getting started and accessing the information you thirst for can be found throughout the documentation below.


There are two ways through which you can install trakt

Install Via Pip

To install with pip, just run this in your terminal:

$ pip install trakt

Get the code

trakt is available on GitHub.

You can either clone the public repository:

$ git clone git://github.com/moogar0880/PyTrakt.git

Download the tarball:

$ curl -OL https://github.com/moogar0880/PyTrakt/tarball/master

Or, download the zipball:

$ curl -OL https://github.com/moogar0880/PyTrakt/zipball/master

Once you have a copy of the source, you can embed it in your Python package, or install it into your site-packages easily:

$ python setup.py install


Pull requests are graciously accepted. Any pull request should not break any tests and should pass flake8 style checks (unless otherwise warranted). Additionally the user opening the Pull Request should ensure that their username and a link to their GitHub page appears in CONTRIBUTORS.md.


The following lists define the known functionality provided by the Trakt.tv API which this module does not yet have support for. The current plan is that support for the following features will be added over time. As always, if you would like a feature added sooner rather than later, pull requests are most definitely appreciated.

High Level API Features

  • Pagination


  • Create a comment class to facilitate - returning an instance when a comment is created, instead of None - add ability to update and delete comments
  • Add checkin support


  • movies/popular
  • movies/played/{time_period}
  • movies/watched/{time_period}
  • movies/collected/{time_period}
  • movies/anticipated
  • movies/boxoffice
  • movies/{slug}/stats


  • Played
  • Watched
  • Collected
  • Anticipated
  • Collection Progress
  • Watched Progress
  • Stats


  • extended - images - episodes - full
  • stats


  • stats


  • hidden everything
  • likes - comments
  • comments
  • UserList - comments
  • history
  • watchlists - seasons - episodes