Get retrospective user-related summaries about past years.

user_in_review(
  steamid,
  year = 2023,
  force_regenerate = FALSE,
  access_source = FALSE
)

friends_in_review(steamid, year = 2023, return_private = FALSE)

achievements_in_review(steamid, appids, year = 2023, total_only = FALSE)

screenshots_in_review(steamid, appids, year = 2023)

Arguments

steamid

SteamID of a user. The SteamID must be in a format that can be converted by convert_steamid. This includes vanity, Steam64, Steam2, and Steam3 IDs.

year

Review year to return data for. Must be a year smaller than the current year, otherwise the response will be empty.

force_regenerate

Whether to regenerate the year in review or re-use a previously generated summary.

access_source

Unknown.

return_private

Unknown.

appids

A vector of multiple appIDs of applications in the Steam store. There are generally two ways of retrieving an appID:

  • Inspect or parse the store URL of an application, e.g. https://store.steampowered.com/app/10/CounterStrike/

  • Query applications programmatically, e.g. using search_apps

total_only

If TRUE, returns only a summary list of achievements in year.

Value

user_in_review

A nested list containing lots of information about playtime, performance, and game acquisitions.

friends_in_review

A dataframe containing all newly befriended Steam friends. The columnsprivacy_state and rt_privacy_updated tell about the friends' privacy state.

achievements_in_review

A dataframe with one row per appID. all_time_unlocked_achievements and unlocked_more_in_future tell about past and future achievements. achievements is a nested dataframe that contains all achievement for a specific game in year

Examples

if (FALSE) { # \dontrun{
steamid <- "76561197960435530"

# get all sorts of summary data from 2023
user_in_review(steamid, year = 2023)

# all new friends in 2023
# authentication necessary
friends_in_review(steamid, year = 2023)

# get a list of all achievements in 2023
achievements_in_review(steamid, appids = c(440, 730), year = 2023)

# return a summary of total achievements in 2023
achievements_in_review(
  steamid,
  appids = c(440, 730),
  year = 2023,
  total_only = TRUE
)

# return a summary of screenshots in 2023
# actually, this returns an empty tibble because I couldn't
# find an example of a working user/app combination
screenshots_in_review(steamid, year = 2023)
} # }