get_match_history: A list of Matches

Description Usage Arguments Details Value Steam API Documentation Examples

Description

A list of matches based on various parameters.

Usage

1
2
3
4
5
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.

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:

Value

A dota_api object containing the elements described in the details.

Steam API Documentation

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

Examples

1
2
3
4
5
6
7
## 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)

LyzandeR/RDota2 documentation built on May 7, 2019, 2:03 p.m.