kate/hltv-api
1
0
Fork 0
mirror of https://github.com/SocksPls/hltv-api synced 2025-04-30 07:33:09 +00:00
Code Issues Releases Wiki Activity

Merge pull request #31 from SocksPls/update-readme-after-date-format-branch

Browse source 
chore(README): update/remove outdated
This commit is contained in:
David Silva 2022-07-14 13:53:20 +02:00 • committed by GitHub
commit 67f7217b5f
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 200 additions and 272 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

472
README.md
View file

@ -7,35 +7,52 @@ Provides an API for HLTV
```python ```python
>>> import main as hltv >>> import main as hltv
>>> hltv.top5teams() >>> hltv.top5teams()
['Vitality', 'Heroic', 'Astralis', 'Natus Vincere', 'BIG'] [{'name': 'Natus Vincere', 'url': 'https://hltv.org/team/4608/natus-vincere'},
{'name': 'FaZe', 'url': 'https://hltv.org/team/6667/faze'},
{'name': 'ENCE', 'url': 'https://hltv.org/team/4869/ence'},
{'name': 'Cloud9', 'url': 'https://hltv.org/team/5752/cloud9'},
{'name': 'Vitality', 'url': 'https://hltv.org/team/9565/vitality'}]
``` ```
## `top30teams` ## `top30teams`
```python ```python
>>> hltv.top30teams() >>> hltv.top30teams()
[{'name': 'Vitality', [{'name': 'Natus Vincere',
'rank': 1, 'rank': 1,
'rank-points': 913, 'rank-points': 935,
'team-id': 9565, 'stats-url': 'https://www.hltv.org/ranking/teams/2022/july/11/details/4608',
'team-players': [{'name': "Richard 'shox' Papillon", 'player-id': 1225}, 'team-id': 4608,
{'name': "Cédric 'RpK' Guipouy", 'player-id': 7169}, 'team-players': [{'name': "Aleksandr 's1mple' Kostyliev",
{'name': "Dan 'apEX' Madesclaire", 'player-id': 7322}, 'player-id': 7998,
{'name': "Mathieu 'ZywOo' Herbaut", 'player-id': 11893}, 'url': 'https://www.hltv.org/player/7998/s1mple'},
{'name': "Kévin 'misutaaa' Rabier", 'player-id': 14176}]}, {'name': "Denis 'electroNic' Sharipov",
'player-id': 8918,
'url': 'https://www.hltv.org/player/8918/electronic'},
{'name': "Viktor 'sdy' Orudzhev",
'player-id': 12731,
'url': 'https://www.hltv.org/player/12731/sdy'},
{'name': "Ilya 'Perfecto' Zalutskiy",
'player-id': 16947,
'url': 'https://www.hltv.org/player/16947/perfecto'},
{'name': "Valeriy 'b1t' Vakhovskiy",
'player-id': 18987,
'url': 'https://www.hltv.org/player/18987/b1t'}],
'team-url': 'https://hltv.org/team/4608/Natus Vincere'},
... ...
}] ]
``` ```
## `top_players` ## `top_players`
```python ```python
>>> hltv.top_players() >>> hltv.top_players()
[{'country': b'France', [{'country': 'France',
'maps-played': '1020',
'name': 'Mathieu Herbaut', 'name': 'Mathieu Herbaut',
'nickname': b'ZywOo', 'nickname': 'ZywOo',
'rating': b'1.28', 'rating': '1.27',
'maps-played': b'733'}, 'url': 'https://hltv.org/stats/players/11893/zywoo'},
... ...
}] }]
``` ```
@ -44,267 +61,168 @@ Provides an API for HLTV
```python ```python
>>> hltv.get_players("6665") >>> hltv.get_players("6665")
[{'id': '4954', 'nickname': 'Xyp9x', 'name': "Andreas 'Xyp9x' Højsleth"}, [{'id': '4954',
{'id': '7398', 'nickname': 'dupreeh', 'name': "Peter 'dupreeh' Rasmussen"}, 'name': "Andreas 'Xyp9x' Højsleth",
{'id': '7412', 'nickname': 'gla1ve', 'name': "Lukas 'gla1ve' Rossander"}, 'nickname': 'Xyp9x',
{'id': '7592', 'nickname': 'device', 'name': "Nicolai 'device' Reedtz"}, 'url': 'https://hltv.org/player/4954/xyp9x'},
{'id': '9032', 'nickname': 'Magisk', 'name': "Emil 'Magisk' Reif"}] {'id': '7412',
``` 'name': "Lukas 'gla1ve' Rossander",
'nickname': 'gla1ve',
## `get_player_info` 'url': 'https://hltv.org/player/7412/gla1ve'},
{'id': '9078',
```python 'name': "Kristian 'k0nfig' Wienecke",
>>>hltv.get_player_info('7398') 'nickname': 'k0nfig',
{'nickname': b'dupreeh', 'url': 'https://hltv.org/player/9078/k0nfig'},
'name': b'Peter Rasmussen', {'id': '13300',
'country': 'Denmark', 'name': "Asger 'Farlig' Jensen",
'team': b'Astralis', 'nickname': 'Farlig',
'age': '27', 'url': 'https://hltv.org/player/13300/farlig'},
'stats': {'total_kills': '32442', {'id': '15165',
'headshot_percent': '50.6%', 'name': "Benjamin 'blameF' Bremer",
'total_deaths': '28386', 'nickname': 'blameF',
'kd_ratio': '1.14', 'url': 'https://hltv.org/player/15165/blamef'}]
'dmg_per_round': '78.2',
'grenade_dmg_per_round': '3.0',
'maps_played': '1690',
'rounds_played': '43830',
'kills_per_round': '0.74',
'assists_per_round': '0.14',
'deaths_per_round': '0.65',
'saved_by_teammate_per_round': '0.10',
'saved_teammates_per_round': '0.09',
'rating_1': '1.09'}}
``` ```
## `get_team_info` ## `get_team_info`
```python ```python
>>> hltv.get_team_info("6667") >>> hltv.get_team_info("6665")
{'team-name': b'FaZe', {'current-lineup': [{'country': 'Denmark',
'current-lineup': [{'country': 'Sweden', 'maps-played': 1239,
'name': 'Olof Kajbjer', 'name': 'Andreas Højsleth',
'nickname': 'olofmeister', 'nickname': 'Xyp9x',
'maps-played': 543}, 'url': 'https://hltv.org/stats/players/4954/xyp9x'},
{'country': 'Norway', {'country': 'Denmark',
'name': 'Håvard Nygaard', 'maps-played': 1094,
'nickname': 'rain', 'name': 'Lukas Rossander',
'maps-played': 1044}, 'nickname': 'gla1ve',
{'country': 'Denmark', 'url': 'https://hltv.org/stats/players/7412/gla1ve'},
'name': 'Markus Kjærbye', {'country': 'Denmark',
'nickname': 'Kjaerbye', 'maps-played': 139,
'maps-played': 59}, 'name': 'Kristian Wienecke',
{'country': 'Brazil', 'nickname': 'k0nfig',
'name': 'Marcelo David', 'url': 'https://hltv.org/stats/players/9078/k0nfig'},
'nickname': 'coldzera', {'country': 'Denmark',
'maps-played': 233}, 'maps-played': 82,
{'country': 'Latvia', 'name': 'Asger Jensen',
'name': 'Helvijs Saukants', 'nickname': 'Farlig',
'nickname': 'broky', 'url': 'https://hltv.org/stats/players/13300/farlig'},
'maps-played': 233}], {'country': 'Denmark',
'historical-players': [{'country': b'Poland', 'maps-played': 139,
'name': 'Filip Kubski', 'name': 'Benjamin Bremer',
'nickname': b'NEO', 'nickname': 'blameF',
'maps-played': 45}, 'url': 'https://hltv.org/stats/players/15165/blamef'}],
{'country': b'Slovakia', 'historical-players': [{'country': 'Denmark',
'name': 'Ladislav Kovács', 'maps-played': 86,
'nickname': b'GuardiaN', 'name': 'Lucas Andersen',
'maps-played': 484}, 'nickname': 'Bubzkji',
{'country': b'Lithuania', 'url': 'https://hltv.org/stats/players/9612/bubzkji'},
'name': 'Aurimas Pipiras', {'country': 'Denmark',
'nickname': b'Bymas', 'maps-played': 86,
'maps-played': 41}, 'name': 'Lucas Andersen',
{'country': b'Denmark', 'nickname': 'Bubzkji',
'name': 'Finn Andersen', 'url': 'https://hltv.org/stats/players/9612/bubzkji'},
'nickname': b'karrigan', {'country': 'Denmark',
'maps-played': 548}, 'maps-played': 1076,
{'country': b'Kazakhstan', 'name': 'Nicolai Reedtz',
'name': 'Dauren Kystaubayev', 'nickname': 'device',
'nickname': b'AdreN', 'url': 'https://hltv.org/stats/players/7592/device'},
'maps-played': 65}, {'country': 'Denmark',
{'country': b'Sweden', 'maps-played': 1179,
'name': 'Richard Landström', 'name': 'Peter Rasmussen',
'nickname': b'Xizt', 'nickname': 'dupreeh',
'maps-played': 59}, 'url': 'https://hltv.org/stats/players/7398/dupreeh'},
{'country': b'Sweden', {'country': 'Denmark',
'name': 'Mikail Bill', 'maps-played': 53,
'nickname': b'Maikelele', 'name': 'Patrick Hansen',
'maps-played': 25}, 'nickname': 'es3tag',
{'country': b'Portugal', 'url': 'https://hltv.org/stats/players/8611/es3tag'},
'name': 'Ricardo Pacheco', {'country': 'Denmark',
'nickname': b'fox', 'maps-played': 185,
'maps-played': 88}, 'name': 'Finn Andersen',
{'country': b'Finland', 'nickname': 'karrigan',
'name': 'Aleksi Jalli', 'url': 'https://hltv.org/stats/players/429/karrigan'},
'nickname': b'allu', {'country': 'Denmark',
'maps-played': 237}, 'maps-played': 355,
{'country': b'Norway', 'name': 'Markus Kjærbye',
'name': 'Joakim Myrbostad', 'nickname': 'Kjaerbye',
'nickname': b'jkaem', 'url': 'https://hltv.org/stats/players/8394/kjaerbye'},
'maps-played': 180}, {'country': 'Denmark',
{'country': b'Norway', 'maps-played': 732,
'name': 'Jorgen Robertsen', 'name': 'Emil Reif',
'nickname': b'cromen', 'nickname': 'Magisk',
'maps-played': 27}, 'url': 'https://hltv.org/stats/players/9032/magisk'},
{'country': b'Bosnia and Herzegovina', {'country': 'Denmark',
'name': 'Nikola Kovač', 'maps-played': 12,
'nickname': b'NiKo', 'name': 'Danny Sørensen',
'maps-played': 799}, 'nickname': 'zonic',
{'country': b'Denmark', 'url': 'https://hltv.org/stats/players/21/zonic'},
'name': 'Philip Aistrup', {'country': 'Denmark',
'nickname': b'aizy', 'maps-played': 90,
'maps-played': 218}, 'name': 'René Borg',
{'country': b'France', 'nickname': 'cajunb',
'name': 'Fabien Fiey', 'url': 'https://hltv.org/stats/players/2469/cajunb'},
'nickname': b'kioShiMa', {'country': 'Denmark',
'maps-played': 280}, 'maps-played': 103,
{'country': b'Sweden', 'name': 'Philip Ewald',
'name': 'Robert Dahlström', 'nickname': 'Lucky',
'nickname': b'RobbaN', 'url': 'https://hltv.org/stats/players/13843/lucky'},
'maps-played': 2}, {'country': 'Norway',
{'country': b'Australia', 'maps-played': 10,
'name': 'Karlo Pivac', 'name': 'Ruben Villarroel',
'nickname': b'USTILO', 'nickname': 'RUBINO',
'maps-played': 1}, 'url': 'https://hltv.org/stats/players/1485/rubino'},
{'country': b'Denmark', {'country': 'Denmark',
'name': 'Jesper Plougmann', 'maps-played': 1,
'nickname': b'TENZKI', 'name': 'Frederik Sørensen',
'maps-played': 2}, 'nickname': 'Fessor',
{'country': b'Serbia', 'url': 'https://hltv.org/stats/players/16718/fessor'},
'name': 'Janko Paunović', {'country': 'Denmark',
'nickname': b'YNk', 'maps-played': 4,
'maps-played': 8}, 'name': 'Anton Pedersen',
{'country': b'Sweden', 'nickname': 'notaN',
'name': 'Zebastian Molinder', 'url': 'https://hltv.org/stats/players/9903/notan'},
'nickname': b'zbM', {'country': 'Denmark',
'maps-played': 1}], 'maps-played': 15,
'stats': {b'Maps played': b'1044', 'name': 'Jakob Hansen',
b'Wins / draws / losses': b'593 / 5 / 446', 'nickname': 'JUGi',
b'Total kills': b'94441', 'url': 'https://hltv.org/stats/players/8783/jugi'},
b'Total deaths': b'89842', {'country': 'Denmark',
b'Rounds played': b'27494', 'maps-played': 4,
b'K/D Ratio': b'1.05'}} 'name': 'Jacob Winneche',
'nickname': 'Pimp',
'url': 'https://hltv.org/stats/players/7154/pimp'},
{'country': 'Denmark',
'maps-played': 9,
'name': 'Marco Pfeiffer',
'nickname': 'Snappi',
'url': 'https://hltv.org/stats/players/922/snappi'},
{'country': 'Sweden',
'maps-played': 8,
'name': 'Dennis Edman',
'nickname': 'dennis',
'url': 'https://hltv.org/stats/players/1146/dennis'}],
'stats': {'K/D Ratio': '1.10',
'Maps played': '1323',
'Rounds played': '34752',
'Total deaths': '110203',
'Total kills': '120679',
'Wins / draws / losses': '860 / 2 / 461'},
'team-name': 'Astralis',
'url': 'https://hltv.org/stats/team/6665/Astralis'}
``` ```
## `get_match_info`
```python
>>> get_match_info("77841")
{'team1': {'name': 'Astralis',
'players': ['device', 'Magisk', 'Xyp9x', 'dupreeh', 'gla1ve'],
'device': {'kills': '67',
'headshots': '23',
'assists': '17',
'flash_assists': '7',
'deaths': '61',
'kast': '71.9%',
'kd_diff': '+6',
'adr': '84.8',
'fk_diff': '+7',
'rating': '1.17'},
'Magisk': {'kills': '59',
'headshots': '25',
'assists': '12',
'flash_assists': '3',
'deaths': '64',
'kast': '68.5%',
'kd_diff': '-5',
'adr': '77.3',
'fk_diff': '+4',
'rating': '1.03'},
'Xyp9x': {'kills': '58',
'headshots': '24',
'assists': '22',
'flash_assists': '8',
'deaths': '58',
'kast': '69.7%',
'kd_diff': '0',
'adr': '72.6',
'fk_diff': '+1',
'rating': '1.02'},
'dupreeh': {'kills': '56',
'headshots': '33',
'assists': '15',
'flash_assists': '2',
'deaths': '61',
'kast': '66.3%',
'kd_diff': '-5',
'adr': '59.7',
'fk_diff': '+1',
'rating': '0.94'},
'gla1ve': {'kills': '45',
'headshots': '19',
'assists': '22',
'flash_assists': '9',
'deaths': '65',
'kast': '60.7%',
'kd_diff': '-20',
'adr': '62.5',
'fk_diff': '-8',
'rating': '0.79'}},
'team2': {'name': 'G2',
'players': ['NiKo', 'huNter-', 'AmaNEk', 'nexa', 'kennyS'],
'NiKo': {'kills': '67',
'headshots': '23',
'assists': '17',
'flash_assists': '7',
'deaths': '61',
'kast': '71.9%',
'kd_diff': '+6',
'adr': '84.8',
'fk_diff': '+7',
'rating': '1.17'},
'huNter-': {'kills': '59',
'headshots': '25',
'assists': '12',
'flash_assists': '3',
'deaths': '64',
'kast': '68.5%',
'kd_diff': '-5',
'adr': '77.3',
'fk_diff': '+4',
'rating': '1.03'},
'AmaNEk': {'kills': '58',
'headshots': '24',
'assists': '22',
'flash_assists': '8',
'deaths': '58',
'kast': '69.7%',
'kd_diff': '0',
'adr': '72.6',
'fk_diff': '+1',
'rating': '1.02'},
'nexa': {'kills': '56',
'headshots': '33',
'assists': '15',
'flash_assists': '2',
'deaths': '61',
'kast': '66.3%',
'kd_diff': '-5',
'adr': '59.7',
'fk_diff': '+1',
'rating': '0.94'},
'kennyS': {'kills': '45',
'headshots': '19',
'assists': '22',
'flash_assists': '9',
'deaths': '65',
'kast': '60.7%',
'kd_diff': '-20',
'adr': '62.5',
'fk_diff': '-8',
'rating': '0.79'}}}
```
## `get_matches` ## `get_matches`
```python ```python
>>> hltv.get_matches() >>> hltv.get_matches()
[{'date': '2022-06-06', [{'countdown': '1:15:00',
'event': b'WePlay Academy League Season 4', 'date': '2022-07-14',
'team1': b'Astralis Talent', 'event': 'ESL Challenger Melbourne 2022 Asia Closed Qualifier',
'team2': b'Apeks Rebels', 'team1': 'IHC',
'time': '18:10', 'team2': 'Wings Up',
'url': 'https://hltv.org/matches/2356500/astralis-talent-vs-apeks-rebels-weplay-academy-league-season-4'}, 'time': '15:00',
'url': 'https://hltv.org/matches/2357388/ihc-vs-wings-up-esl-challenger-melbourne-2022-asia-closed-qualifier'},
... ...
] ]
``` ```
@ -313,19 +231,29 @@ Provides an API for HLTV
```python ```python
>>> hltv.get_results() >>> hltv.get_results()
[{'date': '10/11/2020', [{'date': '2022-07-14',
'event': b'IEM Beijing-Haidian 2020 North America', 'event': 'ESL Challenger Melbourne 2022 Asia Closed Qualifier',
'team1': b'Liquid', 'team1': 'YK',
'team1score': 2, 'team1score': 0,
'team2': b'Chaos', 'team2': 'Wings Up',
'team2score': 0}, 'team2score': 2,
'url': 'https://hltv.org/matches/2357387/yk-vs-wings-up-esl-challenger-melbourne-2022-asia-closed-qualifier'},
... ...
}] ]
``` ```
## `get_results_by_date` ## `get_results_by_date`
```python ```python
>>> hltv.get_results_by_date() >>> hltv.get_results_by_date()
[{'team2score': 16, 'team1': 'AGO', 'team2': 'G2', 'team1score': 8, 'map': 'Inferno', 'date': '2018-2-15', 'event': 'ESL Pro League Season 7 Europe'}, ... ] [{'date': '2022-07-14',
'event': 'ESL Challenger Melbourne 2022 Asia Closed Qualifier',
'map': 'Overpass',
'team1': 'Wings Up',
'team1score': 16,
'team2': 'YK',
'team2score': 8,
'url': 'https://hltv.org/stats/matches/mapstatsid/140750/wings-up-vs-yk?startDate=2022-07-14&endDate=2022-07-14'},
...
]
``` ```