Owned Games
SteamWebAPIs.get_owned_games
— Functionget_owned_games(steamid::Int;
include_appinfo::Bool=false,
include_played_free_games::Bool=false)::OwnedGames
Summary: get_owned_games
returns a list of games a player owns along with some playtime information, if the profile is publicly visible. Private, friends-only, and other privacy settings are not supported unless you are asking for your own personal details (ie the WebAPI key you are using is linked to the steamid you are requesting).
Arguments
steamid
: The SteamID of the account.
Optional keywords
include_appinfo
: Include game name and logo information in the output. The default is to return appids only.include_played_free_games
: By default, free games like Team Fortress 2 are excluded (as technically everyone owns them). If includeplayedfree_games is set, they will be returned if the player has played them at some point. This is the same behavior as the games list on the Steam Community.
Example
julia> dump(recent_games = get_recently_played_games(76561198202322923,count=1))
SteamWebAPIs.RecentGames
total_count: Int64 5
games: Array{SteamWebAPIs.RecentGame}((1,))
1: SteamWebAPIs.RecentGame
appid: Int64 359550
name: String "Tom Clancy's Rainbow Six Siege"
playtime_2weeks: Int64 811
playtime_forever: Int64 60942
img_icon_url: String "624745d333ac54aedb1ee911013e2edb7722550e"
SteamWebAPIs.OwnedGames
— Typestruct OwnedGames
game_count::Int
games::Vector{Game}
end
Return type of get_owned_games
.
Fields:
game_count
: The total number of games the user owns (including free games they've played, if includeplayedfree_games was passed).games
: A [Game
]@ref Vector.
SteamWebAPIs.Game
— Typestruct Game
appid::Int
playtime_forever::Int
playtime_windows_forever::Int
playtime_mac_forever::Int
playtime_linux_forever::Int
playtime_deck_forever::Int
rtime_last_played::Union{DateTime,Nothing}
playtime_disconnected::Int
# include_appinfo:
name::Union{String,Nothing}
img_icon_url::Union{String,Nothing}
has_leaderboards::Union{Bool,Nothing}
has_community_visible_stats::Union{Bool,Nothing}
content_descriptorids::Union{Vector{Int},Nothing}
end
Owned game information.
Fields:
appid
: Unique identifier for the game.playtime_forever
: The total number of minutes played "on record", since Steam began tracking total playtime in early 2009.playtime_windows_forever
: The total number of minutes played on Windows.playtime_mac_forever
: The total number of minutes played on Mac.playtime_linux_forever
: The total number of minutes played on Linux.playtime_deck_forever
: The total number of minutes played on Steam Deck.rtime_last_played
: Recent play time.playtime_disconnected
: The total number of minutes played offline.name
: The name of the game.img_icon_url
: These are the filenames of various images for the game. To construct the URL to the image, use this format: http://media.steampowered.com/steamcommunity/public/images/apps/{appid}/{hash}.jpg. For example, the TF2 logo is returned as "07385eb55b5ba974aebbe74d3c99626bda7920b8", which maps to the URL.has_leaderboards
: Does this game have a leaderboard.has_community_visible_stats
: Indicates there is a stats page with achievements or other game stats available for this game. The uniform URL for accessing this data is http://steamcommunity.com/profiles/{steamid}/stats/{appid}.content_descriptorids
: Unknow.
Recently Played Games
SteamWebAPIs.get_recently_played_games
— Functionget_recently_played_games(steamid::Int;count=1)::RecentGames
Summary: get_recently_played_games
returns a list of games a player has played in the last two weeks, if the profile is publicly visible. Private, friends-only, and other privacy settings are not supported unless you are asking for your own personal details (ie the WebAPI key you are using is linked to the steamid you are requesting).
Arguments
steamid
: The SteamID of the account.
Optional keywords
count
: Optionally limit to a certain number of games (the number of games a person has played in the last 2 weeks is typically very small)
Example
julia> dump(get_recently_played_games(76561198309475951,count=1))
SteamWebAPIs.RecentGames
total_count: Int64 5
games: Array{SteamWebAPIs.RecentGame}((1,))
1: SteamWebAPIs.RecentGame
appid: Int64 359550
name: String "Tom Clancy's Rainbow Six Siege"
playtime_2weeks: Int64 811
playtime_forever: Int64 60942
img_icon_url: String "624745d333ac54aedb1ee911013e2edb7722550e"
SteamWebAPIs.RecentGames
— Typestruct RecentGames
total_count::Int
games::Vector{RecentGame}
end
Return type of get_recently_played_games
.
Fields:
total_count
: The total number of unique games the user has played in the last two weeks. This is mostly significant if you opted to return a limited number of games with the count input parameter.games
: A [RecentGame
]@ref Vector.
SteamWebAPIs.RecentGame
— Typestruct RecentGame
appid::Int
name::String
playtime_2weeks::Int
playtime_forever::Int
img_icon_url::String
end
Recently played game information.
Fields:
appid
: Unique identifier for the game.name
: The name of the game.playtime_2weeks
: The total number of minutes played in the last 2 weeks.playtime_forever
: The total number of minutes played "on record", since Steam began tracking total playtime in early 2009.img_icon_url
: These are the filenames of various images for the game. To construct the URL to the image, use this format: http://media.steampowered.com/steamcommunity/public/images/apps/{appid}/{hash}.jpg. For example, the TF2 logo is returned as "07385eb55b5ba974aebbe74d3c99626bda7920b8", which maps to the URL.