hltv-async-api 0.5.3

Hltv-aio An unofficial asynchronous HLTV API Wrapper for Python

hltv-async-api an unofficial asynchronous HLTV API Wrapper for Python

This page not completed, not all methods and configs are written

Features

• Simple Usage (its realy simple)

• New and modern fully async library

• Huge amount of options

• Supports proxy usage

• Made with love <3

---

Installation

pip install hltv-async-api

---

Simple Usage

```
from hltv_async_api import Hltv

hltv = Hltv()
print(await hltv.get_events())
```

---

Proxy Usage

Load Proxies from list

```
proxy_list = ['http://120.234.203.171:9002', 'http://110.38.68.38:80']

hltv = Hltv(use_proxy=True, proxy_list=proxy_list)
```

Load Proxies from file

```
hltv = Hltv(use_proxy=True, proxy_path='PATH_TO_PROXY.TXT')
```

One-time proxy

```
hltv = Hltv(use_proxy=True, proxy_path='PATH_TO_PROXY.TXT', proxy_one_time=True)
```

Protocol usage

```
proxy_list = ['120.234.203.171:9002', '110.38.68.38:80']

hltv = Hltv(use_proxy=True, proxy_list=proxy_list, proxy_protocol='http')
```

---

Methods

• get_matches(days: int = 1, min_star_rating: int = 1, live: bool = True, future: bool = True)

  -days (the number of days into the future to fetch matches for)

  -min_star_rating (the minimum star rating for matches to include)

  await hltv.get_matches(days=1)
  
  >>> [{'id': '2371201', 'date': 'LIVE', 'time': 'LIVE', 'team1': 'Imperial', 'team2': 'MIBR', 't1_id': '9455', 't2_id': '9215', 'maps': '3', 'rating': 1, 'event': 'RES Regional Series 3 LATAM'}, {'id': '2370964', 'date': '2024-04-16', 'time': '12:30', 'team1': 'SAW', 'team2': 'Sampi', 't1_id': '10567', 't2_id': '10695', 'maps': '3', 'rating': 1, 'event': 'Thunderpick World Championship 2024 EU Closed Qualifier 1'}, {'id': '2371367', 'date': '2024-04-16', 'time': '14:00', 'team1': 'Gaimin Gladiators', 'team2': 'Permitta', 't1_id': '11571', 't2_id': '12009', 'maps': '3', 'rating': 1, 'event': 'Elisa Invitational Spring 2024'}]
  
  

• **get_match_info(match_id: int | str, team1, team2, event_title)

  await hltv.get_match_info(2370931, 'Mouz', 'faze', 'iem-chengdu-2024')  
  
  >>>(2370931, '0', '2', 'Match over', [{'mapname': 'Overpass', 'r_team1': '10', 'r_team2': '13'}, {'mapname': 'Nuke', 'r_team1': '6', 'r_team2': '13'}, {'mapname': 'Mirage', 'r_team1': '-', 'r_team2': '-'}], [{'id': '18850', 'nickname': 'Jimpphat', 'kd': '33-29', 'adr': '80.9', 'rating': '1.08'}, 
  
  {'id': '18072', 'nickname': 'torzsi', 'kd': '26-25', 'adr': '70.5', 'rating': '1.02'}, {'id': '13666', 'nickname': 'Brollan', 'kd': '25-31', 'adr': '68.4', 'rating': '0.90'}, {'id': '20312', 'nickname': 'xertioN', 'kd': '23-31', 'adr': '62.4', 'rating': '0.82'}, {'id': '16820', 'nickname': 'siuhy', 'kd': '17-30', 'adr': '51.6', 'rating': '0.70'}, {'id': '18053', 'nickname': 'broky', 'kd': '34-22', 'adr': '79.3', 'rating': '1.33'}, {'id': '9960', 'nickname': 'frozen', 'kd': '33-23', 'adr': '85.5', 'rating': '1.31'}, {'id': '11816', 'nickname': 'ropz', 'kd': '31-26', 'adr': '73.0', 'rating': '1.20'}, {'id': '8183', 'nickname': 'rain', 'kd': '27-26', 'adr': '82.0', 'rating': '1.18'}, {'id': '429', 'nickname': 'karrigan', 'kd': '20-28', 'adr': '49.7', 'rating': '0.81'}])  
  
  

• **get_results(days: int = 1, min_rating: int = 1, max: int = 30, featured: bool = True, regular: bool = True)) ->

  print(await hltv.get_results())
  
  [{'id': '2370931', 'team1': 'MOUZ', 'team2': 'FaZe', 'score1': '0', 'score2': '2', 'rating': 0, 'event': 'IEM Chengdu 2024'}]
  

• get_events(outgoing=True, future=True, max_events=10) -> [('id', 'title', 'startdate', 'enddate')]

  await hltv.get_events(future=False)
  
  >>>[{'id': '7749', 'title': 'Thunderpick World Championship 2024 EU Closed Qualifier 1', 'start_date': '1-4', 'end_date': '22-4'}, {'id': '7621', 'title': 'ESL Challenger League Season 47 North America', 'start_date': '13-2', 'end_date': '16-6'}]
    
  

• get_event_results(event_id: int | str, days: int = 1, max_: int = 10)

  await get_event_results(7148)
  
  >>>[{'id': '2370931', 'date': '14-04-2024', 'team1': 'MOUZ', 'team2': 'FaZe', 'score1': '0', 'score2': '2'}]
  
  

• get_event_matches(event_id: str | int, days: int = 1):

  await hltv.get_event_matches(7148)
  
  >>>[{'id': '2370771', 'date': '2024-04-18', 'time': '15:30', 'team1': 'Monte', 'team2': 'paiN', 't1_id': '11811', 't2_id': '4773'}, {'id': '2370772', 'date': '2024-04-18', 'time': '17:00', 'team1': 'Imperial', 'team2': 'Metizport', 't1_id': '9455', 't2_id': '11641'}, {'id': '2370773', 'date': '2024-04-18', 'time': '18:30', 'team1': 'FURIA', 'team2': '9z', 't1_id': '8297', 't2_id': '9996'}, {'id': '2370774', 'date': '2024-04-18', 'time': '20:00', 'team1': 'MIBR', 'team2': 'OG', 't1_id': '9215', 't2_id': '10503'}, {'id': '2370775', 'date': '2024-04-18', 'time': '21:30', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370776', 'date': '2024-04-18', 'time': '23:00', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370777', 'date': '2024-04-19', 'time': '00:00', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370778', 'date': '2024-04-19', 'time': '15:00', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370779', 'date': '2024-04-19', 'time': '17:30', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370780', 'date': '2024-04-19', 'time': '20:00', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370781', 'date': '2024-04-19', 'time': '22:30', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370782', 'date': '2024-04-20', 'time': '00:30', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370783', 'date': '2024-04-20', 'time': '15:00', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}, {'id': '2370784', 'date': '2024-04-20', 'time': '18:00', 'team1': 'TBD', 'team2': 'TBD', 't1_id': 0, 't2_id': 0}]
  
  

• get_event_info(event_id: str | int, event_title: str) -> (event_id, event_title, event_start, event_end, prize, team_num, location, groups)

  await hltv.get_event_info(7148, 'PGL CS2 Major Copenhagen2024')
  
  (7148, 'PGL CS2 Major Copenhagen2024', '21-3', '31-3', '$1,250,000', '16', 'Copenhagen, Denmark', [])
  

• get_top_teams(max_teams=30) -> ['rank', 'title', 'points', 'change', 'id']

  await hltv.get_top_teams(2)
  
  >>>[{'id': '1111', 'rank': '1', 'title': 'FaZe', 'points': '939', 'change': '-', 'id': '6667'}, {'id': '1111', 'rank': '2', 'title': 'Natus Vincere', 'points': '757', 'change': '+4', 'id': '4608'}]
  

• get_team_info(team_id: int | str, title: str) -> (team_id, team_title, rank, [players], coach, average_age, weeks_in_top_20, last_trophy, total_trophys)

  await hltv.get_team_info(6667, 'faze')
  
  >>>(6667, 'faze', '1', ['karrigan', 'rain', 'frozen', 'ropz', 'broky'], 'NEO', '26.6', '258', 'IEM Chengdu 2024', 22)
  

• get_last_news(max_reg_news=2, only_today=True, only_featured=False) -> [date, [featured_id, featured_title, featured_desciption], [regular_id, reg_title, reg_time]]

  await hltv.get_last_news(only_today=True)
  
  >>>[{'date': '15-04', 'f_news': [], 'news': [{'id': '38784', 'title': 'Media: FURIA practicing with kye in place of arT', 'posted': 'an hour ago'}, {'id': '38783', 'title': 'electroNic to play for Virtus.pro at ESL Pro League S19', 'posted': '2 hours ago'}, {'id': '38781', 'title': 'The EVPs and Best Five of IEM Chengdu', 'posted': '7 hours ago'}]}]
  
  

• get_best_players(top: int = 40) -> ('rank', 'name', 'team', 'maps', 'rating')

  await hltv.get_best_players(2)
  
  >>>[{'id': '19230', 'rank': 1, 'name': 'm0NESY', 'team': 'G2', 'maps': '44', 'rating': '1.37'}, {'id': '18053', 'rank': 2, 'name': 'broky', 'team': 'FaZe', 'maps': '54', 'rating': '1.19'}]
  

• get async def get(type: str, id: int | str | None = None, title: str | None = None, team1: str | None = None, team2: str | None = None): (BETA) This method is not finished. Possible types 'events', 'matches', 'teams', also u can add id | title | team1 | team2, to parse more. ex.

  
  await hltv.get('matches', 2371201, 'res-regional-series-3-latam', 'IMPERIAL', 'MIBR')
  
  >>> (2371201, 0, 0, 'LIVE', [{'mapname': 'Vertigo', 'r_team1': '6', 'r_team2': '13'}, {'mapname': 'Mirage', 'r_team1': '-', 'r_team2': '-'}, {'mapname': 'Anubis', 'r_team1': '-', 'r_team2': '-'}], [])
  
  

---

Configs

• max_delay: int = 15

  We automaticly increasing reconnecting delay by 1 sec to max_delay (from 1s to 5s)

  hltv = Hltv(max_delay=5, use_proxy=False)
  
  >>>Fetching https://www.hltv.org/matches/2370727/faze-vs-natus-vincere-pgl-cs2-major-copenhagen-2024, code: 403
  >>>Got 403 forbitten
  >>>Calling again, increasing delay to 4s
  >>>Fetching https://www.hltv.org/matches/2370727/faze-vs-natus-vincere-pgl-cs2-major-copenhagen-2024, code: 403
  >>>Got 403 forbitten
  >>>Calling again, increasing delay to 5s
  

• max_retries: int = 0

  Max retries. 0 or -1 for infinity tries.

  hltv = Hltv(max_retries=2, debug=True)
  print(await hltv.get_best_players())
  
  Creating Session
  Trying connect to https://www.hltv.org/stats/players?startDate=2024-01-01&endDate=2024-12-31&rankingFilter=Top20, try 1/2
  Trying connect to https://www.hltv.org/stats/players?startDate=2024-01-01&endDate=2024-12-31&rankingFilter=Top20, try 2/2
  Connection failed
  

• use_proxy: bool = False

  Proxy Usage. No compatibility with max_delay (max_delay will be ignored)

• proxy_list: list | None = None

  list of your proxies, if your proxies doesnt have any protocol you can use proxy_protocol. Note: To add nonproxy to list just put '' to it, you can find example with ar

• proxy_path: str | None = None

  Path to your proxy (proxy_list will be ignored). If your proxies doesnt have any protocol you can use proxy_protocol

• proxy_protocol: str | None = None,

  Proxy protocol. Your proxies ```hltv = Hltv(proxy_protocol='http' ...) -> '11.11.11.11:1111' -> 'http://11.11.11.11:1111'

• proxy_one_time: bool = False

  Removes proxy from list (proxy_path included) if connection unsuccessfull

• timeout: int = 5

  Max time to close connection. Recommended to use timeout=1 if you are using random proxies.

• debug: bool = False

  More loggs

• true_session=False

  (BETA) This parser automaticaly creating and clossing session after every call, if you want to let your session open even when parser is inactive use this method. !! IMPORTANT YOU SHOULD CLOSE YOUR SESSION BEFORE KILLING PROGRAM

  async def test():
      hltv = Hltv(true_session=True)
      print(await hltv.get_best_players())
      print(await hltv.get_upcoming_matches())
      await hltv.close_session()
  
  if __name__ == "__main__":
      asyncio.run(test())
  

---

Examples

Simple Example

from hltv_async_api import Hltv


async def test():

    hltv = Hltv()
    
    print(await hltv.get_event_info(7148, 'pgl-cs2-major-copenhagen-2024'))

if __name__ == "__main__":
    asyncio.run(test())

Proxy Parser

from hltv_async_api import Hltv


async def test():

    hltv = Hltv(debug=True, use_proxy=True, proxy_path='proxy_test.txt', timeout=1, proxy_one_time=True, proxy_protocol='http')
    
    print(await hltv.get_event_info(7148, 'pgl-cs2-major-copenhagen-2024'))

if __name__ == "__main__":
    asyncio.run(test())

Automatic parser with arq and redis

• to run type "arq PATH_TO_FILE.WorkerSettings"

  import ujson
  import asyncio
  from arq import cron
  from redis.asyncio import Redis, ConnectionPool
  
  from hltv_async_api import Hltv
  
  
  
  async def startup(ctx):
      ctx["hltv"] = Hltv(max_delay=5, use_proxy=True, proxy_list=[settings.PROXY_MAIN, ''], true_session=True, debug=True)
      ctx["redis"] = redis_client = Redis(
          connection_pool=ConnectionPool.from_url(settings.redis_url),
      )
      logger.success(f"Scheduler started. UTC time {datetime.utcnow()}")
  
  
  async def shutdown(ctx):
      await ctx["hltv"].close_session()
      await ctx["redis"].close()
  
  
  async def parse_matches(ctx):
      hltv = ctx["hltv"]
      redis = ctx["redis"]
      matches = await hltv.get_upcoming_matches(1, 1)
      if matches:
          await redis.set("matches", ujson.dumps(matches))
      else:
          logger.error("error parsing matches")
  
  async def parse_events(ctx):
      hltv = ctx["hltv"]
      redis = ctx["redis"]
      events = await hltv.get_events()
      if events:
          await redis.set("events", ujson.dumps(events))
      else:
          logger.error("error parsing events")
  
  
  async def parse_top_teams(ctx):
      hltv = ctx["hltv"]
      redis = ctx["redis"]
      top_teams = await hltv.get_top_teams(30)
      if top_teams:
          await redis.set("top_teams", ujson.dumps(top_teams))
      else:
          logger.error("error parsing top teams")
  
  
  async def parse_top_players(ctx):
      hltv = ctx["hltv"]
      redis = ctx["redis"]
      top_players = await hltv.get_best_players(30)
      if top_players:
          await redis.set("top_teams", ujson.dumps(top_players))
      else:
          logger.error("error parsing top players")
  
  
  async def parse_last_news(ctx):
      hltv = ctx["hltv"]
      redis = ctx["redis"]
      news = await hltv.get_last_news(only_today=True, max_reg_news=4)
      if news:
          await redis.set("news", ujson.dumps(news))
      else:
          logger.error("error parsing news")
  
  
  class WorkerSettings:
      redis_settings = settings.redis_pool
      on_startup = startup
      on_shutdown = shutdown
      functions = [parse_matches,
                   parse_events,
                   parse_top_teams,
                   parse_top_players,
                   parse_last_news,
                   ]
      cron_jobs = [
          cron(parse_matches, minute=59),
          cron(parse_events, hour=0, minute=0, second=0),
          cron(parse_top_teams, day=0, hour=18, minute=1, second=30),
          cron(parse_top_players, day=0, hour=20, minute=0, second=0),
          cron(parse_last_news, minute=55),
      ]
  
  

Requirements:

Python 3.9+

License: HLTV Async is licensed under the MIT License, allowing for personal and commercial use with minimal restrictions.