Skip to contents

Basic API interaction

These functions are basic building blocks – you don’t have to use them directly.

trakt_get()
Make an API call and receive parsed output
trakt_credentials()
Set the required trakt.tv API credentials

Search – Finding media

Searching for items is usually required to retrieve some kind of ID, like the slug, which is required for use of item-specific functions.

search_query() search_id()
Search trakt.tv via text query or ID

Shows and Movies

movies_anticipated() shows_anticipated()
Anticipated media
movies_collected() shows_collected()
Most collected media
comments_trending() comments_recent()
Get trending or recently made comments
lists_popular() lists_trending()
Get popular / trending lists
movies_watching() shows_watching() seasons_watching() episodes_watching()
Get who's watching a thing right now
movies_played() shows_played()
Most played media
movies_popular() shows_popular()
Popular media
movies_trending() shows_trending()
Trending media
movies_watched() shows_watched()
Most watched media

Single-item summary data

episodes_summary()
Get a single episode's details
movies_summary()
Get a single movie
people_summary()
Get a single person's details
seasons_summary()
Get a show's seasons
shows_summary()
Get a single show

Seasons and episodes

seasons_summary()
Get a show's seasons
seasons_season()
Get a season of a show
shows_next_episode() shows_last_episode()
Get a shows next or latest episode

Movie-specific data

movies_boxoffice()
Get the weekend box office
movies_releases()
Get a movie's release details

Media ratings

These functions return the full rating distribution for an item, in contrast to the _summary-methods, which return the average rating of an item.

Media stats

These functions return the number of watchers, plays, collectors, comments, lists and votes of an item.

shows_stats() movies_stats() seasons_stats() episodes_stats()
Get a show or movie's (or season's or episode's) stats

Media related to media.

movies_related()
Get similiar(ish) movies
shows_related()
Get similiar(ish) shows

People – Cast & Crew

Cast and crew for media items, as well as the reverse; credits for people.

people_summary()
Get a single person's details
movies_lists() shows_lists() seasons_lists() episodes_lists() people_lists()
Get lists containing a movie, show, season, episode or person
people_movies() people_shows()
Get a single person's movie or show credits
movies_people() shows_people() seasons_people() episodes_people()
Get the cast and crew of a show or movie

Users

Access user-specific data. This is only possible if the user in question has a public profile or authentication is available and you are friends.

user_collection()
Get a user's collected shows or movies
user_comments()
Get a user's comments
user_history()
Get a user's watch history
user_likes()
Get items (comments, lists) a user likes
user_list()
Get a single list
user_list_comments()
Get comments on a user-created list
user_list_items()
Get a user's list's items
user_lists()
Get a user's lists
user_followers() user_following() user_friends()
Get a user's social connections
user_profile()
Get a user's profile
user_ratings()
Get a user's ratings
user_stats()
Returns stats about the movies, shows, and episodes a user has watched, collected, and rated.
user_watched()
Get a user's watched shows or movies
user_watchlist()
Get a user's watchlist

Miscellaneous content

Lists

Watchlists or topical lists created by trakt.tv users. These can contain all kinds of media types, from movies to episodes to people.

lists_popular() lists_trending()
Get popular / trending lists
movies_lists() shows_lists() seasons_lists() episodes_lists() people_lists()
Get lists containing a movie, show, season, episode or person
user_list()
Get a single list
user_list_comments()
Get comments on a user-created list
user_list_items()
Get a user's list's items
user_lists()
Get a user's lists
user_watchlist()
Get a user's watchlist

Comments

comments_comment() comments_replies() comments_likes() comments_item()
Get a single comment
comments_trending() comments_recent()
Get trending or recently made comments
comments_updates()
Get recently updated/edited comments
movies_comments() shows_comments() seasons_comments() episodes_comments()
Get all comments of a thing
user_comments()
Get a user's comments
user_list_comments()
Get comments on a user-created list

Localization

movies_aliases() shows_aliases()
Get all movie / show aliases
movies_translations() shows_translations() episodes_translations()
Get translations for a movie, show or episode

Utilities

Included for convenience.

build_trakt_url()
Assemble a trakt.tv API URL
pad_episode()
Easy episode number padding

Included Data

Episode datasets

For demonstration purposes.

futurama
Futurama episodes
gameofthrones
Game of Thrones episodes

Internal datasets

These are unlikely to be useful on their own, but they are useful as a reference for optional filters.

This package

tRakt tRakt-package
tRakt: Get Data from 'trakt.tv'