Trakt
Media & VideoTrakt is the TV and movie watch-tracking platform with catalog, calendars, charts, and personal history. Agents search titles, read trending and recommendations, sync collection and watchlist, scrobble and check in, manage lists, and post comments for the connected account.
What This Integration Enables
Trakt is two things wearing one API. It is a catalog with the identifiers everything else uses, so Lookup By ID turns an IMDB or TMDB reference from any upstream system into a canonical title, season, or episode. And it is one person's viewing record: what they own, what they have seen, what they paused halfway, what they rated, and what they said about it in public. FlowRunner agents search and resolve titles, read trending and chart data, follow release calendars, keep a collection and watchlist in sync, scrobble playback, curate lists, and post comments for the connected account.
The second half of that sentence is the part worth slowing down on. Almost every other connector in this category writes to a company's property. This one writes to a human being's profile, under their name, sometimes onto their connected social accounts. Trakt's own design keeps reminding you of that: Get Settings reports the account's permissions and warns when spam protection has revoked one, bulk writes report partial success instead of failing, and removing a play requires a history entry id rather than a title. An agent should read those signals the way the platform intends, and a human-in-the-loop gate belongs wherever the write is public.
Without FlowRunner
With FlowRunner
Use Case Scenarios
A sync that reads only what changed
On a schedule, the agent calls Get Last Activities first, which returns the timestamp of the account's most recent change in every area: watched, collected, rated, watchlisted, commented. Comparing those against what it saw last run tells it which collections actually moved, so a quiet week costs one call instead of a full re-read of Get Sync Collection, Get Watched, and Get Ratings. When something did move, the agent pulls only that area and appends the delta to a sheet in Google Sheets for the household's viewing log.
A release calendar that reaches people before the episode does
The agent walks Get Calendar for the coming week, filtered to the shows the account follows, and enriches each entry with Get Show to pull the next episode details. It posts a digest to Discord or a shared channel in Slack on the morning of a premiere, and writes the week's schedule into a Notion page that anyone can read. Nothing is written back to Trakt, so the flow is entirely a read of the account's own following list against the global calendar.
A watchlist curated from signal rather than memory
The agent reads Get Trending for what is being watched right now and Get Chart for the longer running rankings, then filters both against Get Watched and Get Watchlist so nothing already seen or already queued comes back. Candidates that survive go to Add Items To List on a shared personal list, and the agent reads the not_found array on every write because an unmatched title leaves the call looking successful. When the recommendation engine keeps returning something the account has no interest in, Hide Recommendation corrects the engine itself rather than filtering the result on the client side.
Human-in-Loop Highlight
Check In is the only operation here that can speak to an audience the account never named in the request. It marks the connected profile as watching something now, and its sharing object posts to the user's connected social accounts. Leaving that object out does not mean staying quiet: Trakt falls back to the account's own sharing settings, so silence in the payload can still produce a post on a network the flow never mentioned. It is also exclusive, since only one check in can be active at a time and a second answers 409 with the time the current one expires, which means an automated check in can quietly block the person's own. So the agent stops before it calls. It posts: "Ready to check in to The Bear S03E04 on the Trakt account. Get Settings reports two connected social accounts, and no sharing object means Trakt uses your default, which currently posts to both. Check in and share, check in silently, or just scrobble?" The account owner answers, and the agent sends the sharing object explicitly either way rather than relying on a default. The agent resolved the title, tracked the playback, and knew the state of the account. It did not decide to publish in someone else's name.
Agent Capabilities
39 actionsSearch and Resolution
2- Search Searches Trakt's catalog across movies, shows, episodes, people, and lists at once, or narrowed to some of them. Fields can be restricted so a query matches titles rather than plot summaries.
- Lookup By ID Finds a Trakt record from an id belonging to another service: IMDB, TMDB, TVDB, Trakt itself, and a few others. The operation that connects Trakt to the rest of a media pipeline, since almost every other system identifies titles by IMDB or TMDB id.
Discovery
5- Get Trending Returns what is being watched right now, with the number of people watching each title. A live signal rather than an all time chart.
- Get Chart Returns one of Trakt's ranking charts for movies or shows: popular, most played, most watched, most collected, most anticipated, most favorited, box office, or the streaming and hot feeds. Several of them take a time period, and omitting it returns the weekly chart.
- Get Calendar Returns what is airing or being released in a date range. The target decides whose calendar it is: the global one needs no account, while the personal one covers only shows the connected account follows.
- Get Recommendations Returns personalized movie or show recommendations for the connected account, built from what it has watched and rated.
- Hide Recommendation Removes a title from the connected account's recommendations permanently. This trains the engine rather than filtering the list after the fact.
Catalog
6- Get Movie Reads one movie, or one of its sub resources: ratings, statistics, related titles, people, comments, lists, translations, aliases, releases, studios, videos, or who is watching it right now.
- Get Show Reads one show, or one of its sub resources, including the next or last episode. The next episode is the one a reminder flow wants, because it answers what airs next without walking the season list.
- Get Seasons Lists a show's seasons. Season 0 is the specials season and Trakt includes it, so a count taken from this list needs to filter it out.
- Get Season Episodes Lists the episodes of one season with their numbers, titles, and ids.
- Get Episode Reads one episode, or one of its sub resources: ratings, statistics, comments, people, translations, or who is watching it now.
- Get Person Reads a person, or the movies, shows, or lists they appear in. Credits are split into cast and crew by department.
Sync
9- Get Last Activities Returns the timestamp of the connected account's most recent activity in every area. The operation a sync should start with, because comparing these against what the flow last saw is how Trakt intends a client to decide what needs re-reading.
- Get Sync Collection Returns everything the account has marked as collected, meaning owned rather than watched. Collection and watch history are tracked separately here.
- Get Watched Returns everything the account has watched, with play counts and last played times. For shows it includes which episodes have been seen, which is what a progress feature is built from.
- Get History Returns the account's watch history newest first, with one entry per play rather than one per title. Each entry has its own id, which is what removing a single play takes.
- Get Playback Progress Returns the account's paused playback positions, each with a progress percentage, when it was paused, and its own id for removal.
- Add To Sync Adds items to the account's collection, watch history, watchlist, ratings, or favorites. The response is a partial success report rather than a yes or no, so an item Trakt could not match lands in not_found while the call still looks successful.
- Remove From Sync Removes items from the account's collection, watch history, watchlist, ratings, or favorites. Removing from history takes history entry ids rather than media ids, because the same title can have been watched many times.
- Get Watchlist Returns the account's watchlist. Trakt removes an item automatically once it is watched, so a missing title may have been seen rather than never added.
- Get Ratings Returns the account's ratings, optionally narrowed to one media type or a single rating value.
Watching
3- Scrobble Reports playback progress to Trakt, which is how a player keeps a watch history automatically. The three actions are a sequence rather than alternatives, and a stop above 80 percent progress is recorded as watched while a lower one is saved as a paused position.
- Check In Marks the connected account as watching something now, which shows on their Trakt profile and switches to watched once the runtime has elapsed. Only one check in can be active at a time, and the sharing object decides whether it also posts to connected social accounts. The operation this page's human gate exists for.
- Delete Active Check In Cancels whatever check in is currently active on the account. It needs no item id, and it is what clears the conflict a second check in runs into.
Users
4- Get Settings Reads the account's settings, its connected social accounts, and two objects worth branching on: the list and list item caps, and the permissions Trakt currently allows, which it temporarily reduces when an account trips spam protection.
- Get User Profile Reads a user's public profile. A private profile returns data only to that user or an approved follower, so an empty result can mean privacy rather than a wrong username.
- Get User Stats Returns a user's viewing statistics: movies, shows, and episodes watched, collected, and rated, and the time that adds up to.
- Get User Watching Returns what a user is watching right now. When they are watching nothing, Trakt answers with no body at all, so an empty result means idle rather than failed.
Lists
8- Get User Lists Lists a user's personal lists. Reading what a list contains is a separate call.
- Get List Items Reads the items on a personal list. A list can hold movies, shows, seasons, episodes, and people together, so each entry's type field says what it is.
- Create List Creates a personal list on the connected account. Lists are private by default, and exceeding the account's list cap returns a distinct error that Get Settings explains.
- Update List Updates a list's name, description, privacy, or sorting. Renaming keeps the original slug, so existing links do not break.
- Delete List Deletes a personal list the account owns, along with its items. The titles themselves are untouched.
- Add Items To List Adds movies, shows, seasons, episodes, or people to a personal list. As with sync, the response is a partial success report, so the not_found array has to be read.
- Remove Items From List Removes items from a personal list. Only their membership ends.
- Get Trending Lists Returns the lists other Trakt users are engaging with most right now, or the all time popular ones. A way to discover curated collections rather than individual titles.
Comments
2- Post Comment Posts a comment on a movie, show, season, episode, or list, under the connected account's name. Trakt requires at least five words, and the spoiler flag hides a comment behind a warning.
- Get Comments Reads the comments on a movie, show, season, episode, or list, sorted by likes, replies, rating, or date. Only top level comments come back by default.
Frequently Asked Questions
What can FlowRunner do with Trakt?
FlowRunner agents can run Search, Lookup By ID, and Get Trending in Trakt, plus 36 more actions.
Does connecting Trakt to FlowRunner require OAuth?
Yes. Trakt connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials.
Can Trakt trigger a FlowRunner workflow automatically?
Trakt doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Other Media & Video integrations
Start building with Trakt
$100 in credits. No card required. Connect in minutes.