user_history: Get a user's watch history

In jemus42/tRakt: Get Data from 'trakt.tv'

Get a user's watch history

Description

Retrieve a the last limit items a user has watched, including the method by which it was logged (e.g. scrobble or checkin).

Usage

user_history(
  user = getOption("trakt_username"),
  type = c("shows", "movies"),
  limit = 10L,
  start_at = NULL,
  end_at = NULL,
  extended = c("min", "full")
)

Arguments

user	character(1): Target username (or slug). Defaults to getOption("trakt_username"). Can also be of length greater than 1, in which case the function is called on all user values separately and the result is combined.
type	character(1): Either "shows" or "movies". For season/episode-specific functions, values seasons or episodes are also allowed.
limit	integer(1) [10L]: Number of items to return. Must be greater than 0 and will be coerced via as.integer().
start_at, end_at	character(1): A time-window to filter by. Must be coercible to a datetime object of class POSIXct. See ISOdate for further information.
extended	character(1): Either "min" (API default) or "full". The latter returns more variables and should generally only be used if required. See vignette("finding-things") for more details.

Details

This function wraps the API method ⁠/users/:id/history/:type⁠.

Value

A tibble(). If the function has a limit parameter (defaulting to 10), this will be the (maximum) number of rows of the tibble. If there are no results (or the API is unreachable), an empty tibble() is returned.

Note

For type = "shows", the original output contains a nested object with show and episode data, which are unnested by this function. Due to duplicate variable names, all episode-related variables are prefixed with episode_. This results in the episode number having the name episode_episode, which is quite silly. Sorry.

Source

user_history() wraps endpoint users/:id/history/:type/:item_id?start_at=&end_at=.

See Also

Other user data: user_collection(), user_comments(), user_likes(), user_network(), user_profile(), user_ratings(), user_stats(), user_watched(), user_watchlist()

Examples

## Not run: 
# Shows user "jemus42" watched around christmas 2016
user_history(
  user = "jemus42", type = "shows", limit = 5,
  start_at = "2015-12-24", end_at = "2015-12-28"
)

## End(Not run)

jemus42/tRakt documentation built on April 19, 2024, 3:25 a.m.