RDota2 (version 0.1.6)

get_match_history: A list of Matches

Description

A list of matches based on various parameters.

Usage

get_match_history(hero_id = NULL, game_mode = NULL, skill = NULL, date_min = NULL, date_max = NULL, min_players = NULL, account_id = NULL, league_id = NULL, start_at_match_id = NULL, matches_requested = NULL, tournament_games_only = NULL, tz = "", dota_id = 570, language = "en", key = NULL)

Arguments

hero_id

(optional) The hero id. A list of hero ids can be found via the get_heroes function.

game_mode

(optional) The game mode:

• 0 - None
• 1 - All Pick
• 2 - Captain's Mode
• 3 - Random Draft
• 4 - Single Draft
• 5 - All Random
• 6 - Intro
• 7 - Diretide
• 8 - Reverse Captain's Mode
• 9 - The Greeviling
• 10 - Tutorial
• 11 - Mid Only
• 12 - Least Played
• 13 - New Player Pool
• 14 - Compendium Matchmaking
• 16 - Captain's Draft

No 15 does not exist

skill

(optional) Skill bracket.

• 0 - Any
• 1 - Normal
• 2 - High
• 3 - Very High

date_min

(optional) Minimum date range for returned matches (yyyy-mm-dd HH:MM:SS).

date_max

(optional) Maximum date range for returned matches (yyyy-mm-dd HH:MM:SS).

min_players

(optional) Minimum number of players in match.

account_id

(optional) Account ID.

league_id

(optional) League ID.

start_at_match_id

(optional) Matches equal or older than this ID.

matches_requested

(optional) Amount of matches to return (defaults to 25).

tournament_games_only

(optional) Binary (0 or 1). Whether to return tournament matches.

tz

A time zone specification if date_min and/or date_max are used. See as.POSIXct. "" (default) is the current time zone and "GMT" is UTC.

dota_id

Can take one of three values.

• 570 - Dota 2 (default)
• 816 - Dota 2 Internal Test
• 205790 - Dota 2 Beta Test

language

The ISO639-1 language code for returning all the information in the corresponding language. If the language is not supported, english will be returned. For a complete list of the ISO639-1 language codes please visit https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes.

key

The api key obtained from Steam. If you don't have one please visit https://steamcommunity.com/dev in order to do so. For instructions on the correct way to use this key please visit https://github.com/LyzandeR/RDota2 and check the readme file. You can also see the examples. A key can be made available to all the functions by using key_actions. The key argument in individual functions should only be used in case the user needs to work with multiple keys.

Value

A dota_api object containing the elements described in the details.

Steam API Documentation

https://wiki.teamfortress.com/wiki/WebAPI/GetMatchHistory

Details

A list will be returned that contains three elements. The content, the url and the response received from the api.

The content element of the list contains a list called matches. Each element of matches list is a match. Each match contains the following sections:

• match_id: The match id.
• match_seq_num:A sequence number, representing the order in which matches were recorded.
• start_time: UNIX timestamp of when the game began.
• lobby_type: Check the API Documentation.
• radiant_team_id: Radiant team id.
• dire_team_id: Dire team id.
• players: A list containing information about the players.

Examples

## Not run: 
# get_match_history(matches_requested = 2)
# get_match_history(matches_requested = 2, date_min = '2015-01-01 16:00:00', hero_id = 1)
# get_match_history(language = 'en', key = NULL)
# get_match_history(language = 'en', key = 'xxxxxxxxxxx')
# ## End(Not run)