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.

shows_ratings() movies_ratings() seasons_ratings() episodes_ratings()

Media user ratings

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

Recently updated items

movies_updates() shows_updates()

Recently updated media

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.

trakt_genres trakt_languages trakt_networks trakt_countries trakt_certifications

Cached filter datasets

This package

tRakt-package

tRakt: Get Data from 'trakt.tv'