hoangvu01/hltv_python

*Unofficial* python client library to get data from HLTV webpage.

HLTV API

This is a part of my bigger CS:GO Machine Learning project, but might also be a useful module to scrape data from HLTV.

This package offers built-in methods to get popular information from the website, but also, methods to parse a particular page endpoint. Supported pages can be found in corresponding files in src/hltv_api/pages/.

Installation

pip install hltv-api

Example Usage

Some useful methods:

1. results.get_results - get historical matches along with the overall result
2. stats.get_matches_with_economy - get historical matches with a breakdown equipment value for each round You can find more examples in examples/.

Simple usage

from hltv_api import results

dataframe = results.get_results(limit=5, start_date="1st Sep 2021", end_date="2nd Sep 2021")

print(dataframe.head())

• And the output:

match_id	date	event	team_1	team_2	map	score_1	score_2	stars
2346480	2021-02-09	ESEA Premier Season 36 North America	High Coast	Big Chillin	bo3	1	0	0
2346339	2021-02-09	BLAST Premier Spring Groups 2021	Vitality	Evil Geniuses	bo3	1	2	2
2346493	2021-02-09	ESEA Premier Season 36 Europe	FATE	GamerLegion	bo3	1	2	0
2346490	2021-02-09	ESEA Premier Season 36 Europe	forZe	SAW	bo3	1	2	1
2346494	2021-02-09	ESEA Premier Season 36 Europe	LDLC	Nemiga	bo3	1	2	0

Using more complex HLTV filters

from hltv_api import stats
from hltv_api.query import HLTVQuery

query = HLTVQuery(team_names=["Natus Vincere", "Gambit"], player_names=["s1mple"], 
                  maps=["dust2", "inferno", "mirage"], require_all_teams=True)

dataframe = stats.get_matches_with_economy(limit=2, query=query)

print(dataframe.head())

• And the output:

index	match_id	map	team_1_id	team_2_id	starting_ct	1_team_1_value	1_team_2_value	1_winner	...	30_team_1_value	30_team_2_value	30_winner
0	2349632	ancient	6651	4608	2	4300	4200	2	...	NaN	NaN	NaN
6	2349630	mirage	6651	4608	2	3950	4200	1	...	NaN	NaN	NaN