A minimalistic (but aiming to be comprehensive) library used to interact with Dota 2's (Defense of the Ancients) WebAPI.

First off, you'll need a Steam account. Once you have that you can sign up for an API key. Make sure to keep this key safe (e.g., not committing it to a public repository) as Valve is pretty strict about API access and rate limiting. We'd reccomend throwing it in an environment variable.

Here's how you use it:

>>> from dota2 import Dota2API
>>> api = DOTA2API(api_key='<your-api-key>')
>>> api.get_steam_id('avalonstar')
u'76561198009545200'

It's easy and foolproof! You don't even have to worry about feeding!

pip install dota2

Gets Steam id by vanity name (e.g. http://steamcommunity.com/id/vanity_name)

Arguments

• vanity_name (str)

Gets player summaries given Steam ids

Arguments

• steam_ids (str or iterable)

Gets available heroes list

Gets list of match history

Arguments

• player_name (str)
• hero_id (int or str) (check dota2.HEROES)
• game_mode (int) (check dota2.MATCH_GAME_MODES)
• skill (int) (check dota2.MATCH_SKILL_LEVELS)
• date_min (datetime.datetime or int)
• date_max (datetime.datetime or int)
• min_players (int)
• account_id (int)
• league_id (int)
• start_at_match_id (int)
• matches_requested (int)
• tournament_games_only (int)

Gets details of a match given its id

Arguments

• match_id (int)

Gets list of leagues

Gets list of live league games