Trakt
Movie and TV Data.
About Trakt
Trakt provides a REST API for accessing data about TV shows and movies that users track, including calendars, checkins, collections, lists, ratings, recommendations, scrobbling, search, and sync operations across movies, shows, seasons, episodes, and people. Requests and responses use JSON over HTTPS, with a staging environment available for testing separate from production. Access requires creating an app to obtain a client ID, which is sent along with API version and content-type headers on every call; write operations (POST, PUT, DELETE) require OAuth authentication, while some GET calls support optional OAuth for user-specific data.
The API applies separate rate limits for authenticated and unauthenticated requests, returns standard HTTP status codes for conditions like locked or deactivated accounts, and supports pagination and extended info levels (minimal, images, full, metadata) for controlling response detail. Some methods are restricted to or enhanced for Trakt VIP subscribers, with dedicated status codes and upgrade URLs for handling those cases.
This API is intended for developers building applications or integrations that read or write TV and movie tracking data on top of Trakt's service. Note that this documentation is marked deprecated in favor of docs.trakt.tv as the current reference.
Key features
- Track movies and TV shows watched via a RESTful JSON API
- OAuth-based authentication with device flow support
- Scrobble, checkin, and sync watched history across apps
- Calendars, lists, recommendations, and comments endpoints
- Pagination and extended info levels for movies, shows, episodes, and people
- Sandbox staging environment for testing without affecting production data
Frequently asked questions
Is there a rate limit on the Trakt API?
Yes, unauthenticated and authenticated GET calls are limited to 1000 calls every 5 minutes, and POST/PUT/DELETE calls are limited to 1 call per second.
Does Trakt require authentication?
POST, PUT, and DELETE methods require a valid OAuth access_token, while some GET methods require or optionally accept OAuth.
What format does the Trakt API use?
It is a RESTful API that returns JSON data over HTTPS, accessed at api.trakt.tv.
Is there a way to test the API without affecting production data?
Yes, Trakt provides a separate sandbox environment at api-staging.trakt.tv that requires creating a separate API app.
Are some features limited to paying users?
Yes, certain methods are tagged VIP Only or VIP Enhanced and require a Trakt VIP subscription for access or increased limits.
Show your product to thousands of developers
· 100k monthly pageviews
· 7k newsletter subscribers
