api for liquipedia.net
This is an un-official liquipedia API and is will not be updated anymore
pip install liquipediapy
Please refer to liquipedia's terms of use for rate-limiting information.
The examples directory contains an example files on how to interact with the each class.
create a liquipediapy object
| Param | Type | Description |
|---|---|---|
| appname | string |
The name for your app, you can refer to the liquipedia's terms of use for more information |
| game | string |
name of the game you want to create the object for |
| debug_folder | string |
(Optionnal) Path of the debug folder where you want to store html pages (and read back from it) |
from liquipediapy import liquipediapy
liquipy_object = liquipediapy('appname')
liquipy_object = liquipediapy('appname', 'dota2')
liquipy_object = liquipediapy('appname', 'smash', "F:\\Path\\To\\Debug\\Folder\\")parses a given page example
| Param | Type | Description |
|---|---|---|
| page | string |
name of the page you want to parse |
| Return | Type | Description |
|---|---|---|
| soup | bs4 Object |
a beautifulsoup object |
| redirect_value | string |
if the page has been redirected then returns page value it was redirected to, orderwise returns None |
soup,url = liquipediapy_object.parse('arteezy')returns match details for a given dota2 match, only works if game value in contructor is set to dota2
| Param | Type | Description |
|---|---|---|
| matchId | string |
ID of the match you want details for |
| Return | Type | Description |
|---|---|---|
| match_details | json |
match_details if valid matchID otherwise an error in json |
match_details = liquipediapy_object.dota2webapi('4225454337')searchs liquipedia.net for a given term example
| Param | Type | Description |
|---|---|---|
| serach_value | string |
search term |
| Return | Type | Description |
|---|---|---|
| search_result | json |
response |
search_result = liquipediapy_object.search('mar')create a dota object
| Param | Type | Description |
|---|---|---|
| appname | string |
The name for your app, you can refer to the liquipedia's terms of use for more information |
from liquipediapy import dota
dota_obj = dota("appname")returns all dota players from Portal:Players
[{'country': 'Russia', 'ID': '.Ark', 'Name': 'Egor Zhabotinskii', 'Team': '', 'Links': {'twitter': 'https://twitter.com/just_Ark', 'vk': 'http://vk.com/wtfkaelownage'}},...,{'country': 'China', 'ID': '小郭嘉', 'Name': 'Zhan Yaoyang', 'Team': '', 'Links': {}}, {'country': 'China', 'ID': '闷油瓶', 'Name': 'Wang Liang', 'Team': '', 'Links': {}}]players = dota_obj.get_players()gets information for a specified player
| Param | Type | Description |
|---|---|---|
| playerName | string |
name of player |
| results | bool |
if you want to parse the results page for the player, defauls to False |
{'info': {'image': 'https://liquipedia.net/commons/images/thumb/f/f2/Miracle_SL_i-League.jpg/600px-Miracle_SL_i-League.jpg', 'name': 'عامر البرقاوي', 'romanized_name': 'Amer Al-Barkawi', 'birth_details': 'June 20, 1997 (1997-06-20) (age21)', 'country': ['Jordan', 'Poland'], 'status': 'Active', 'team': 'Team Liquid', 'roles': ['Solo Middle', 'Carry'], 'signature_heros': ['Invoker', 'Anti Mage', 'Shadow Fiend'], 'earnings': 3668824, 'ranking': {'rank': '10', 'points': 3120}}, 'links': {'dotabuff': 'https://www.dotabuff.com/esports/players/105248644',...,'steamcommunity': 'https://steamcommunity.com/profiles/76561198065514372'}, 'history': [{'duration': '2015-01-01 — 2015-04-02', 'name': 'Balkan Bears'},...{'duration': '2016-09-16 — Present', 'name': 'Team Liquid'}], 'achivements': [{'Date': '2018-08-24', 'Placement': '44', 'LP Tier': 'Premier', 'Tournament': 'The International 2018', 'Team': 'Team Liquid', 'Results': '0:2', 'opponent': 'Evil Geniuses', 'Prize': '$1,787,252'},...{'Date': '2015-11-21', 'Placement': '11', 'LP Tier': 'Premier', 'Tournament': 'The Frankfurt Major 2015', 'Team': 'OG', 'Results': '3:1', 'opponent': 'Team Secret', 'Prize': '$1,110,000'}], 'results': [{'Date': '2018-11-30', 'Placement': '22', 'LP Tier': 'Qualifier', 'Tournament': 'The Chongqing Major Europe Qualifier', 'Team': 'Team Liquid', 'Results': '2:1', 'opponent': 'Alliance', 'Prize': '$0'},...{'Date': '2015-01-21', 'Placement': '55 - 8', 'LP Tier': 'Minor', 'Tournament': 'Esportal Dota 2 League Open Tournament 2', 'Team': 'Balkan Bears', 'Results': '1:2', 'opponent': 'MYinsanity', 'Prize': '$0'}]}player_details = dota_obj.get_player_info('Miracle-',True)return all active and inactive teams from Portal:Teams
['Cyber Legacy', 'Effect',....,'FlyToMoon', 'ForZe']teams = dota_obj.get_teams()gets information for a specified team
| Param | Type | Description |
|---|---|---|
| teamName | string |
name of the team |
| results | bool |
if you want to parse the results page for the team, defauls to False |
{'info': {'image': 'https://liquipedia.net/commons/images/thumb/7/7e/Team_Liquid_2020.png/600px-Team_Liquid_2020.png', 'location': ['Netherlands', 'Europe'], 'region': 'Europe', 'coach': 'Blitz', 'director': 'Steve Arhancet Nazgul', 'manager': 'Elya', 'team captain': 'iNSaNiA', 'sponsor': ['Marvel', 'Monster Energy', 'Alienware', 'SAP', 'Honda', 'HyperX', 'Secretlab', 'Twitch', "Jersey Mike's", 'Huya 虎牙直播'], 'earnings': 22991558, 'created': '2000-??-?? 2012-12-06'}, 'links': {'teamliquid': 'https://www.teamliquid.com/', 'liquiddota': 'https://www.liquiddota.com/forum/players-and-teams/495594-team-liquid-discussion', 'facebook': 'https://facebook.com/teamliquid', 'vk': 'https://vk.com/teamliquidpro', 'twitch': 'https://www.twitch.tv/team/teamliquid', 'twitter': 'https://twitter.com/teamliquid', 'weibo': 'https://weibo.com/teamliquid', 'youtube': 'https://www.youtube.com/Team_Liquid', 'instagram': 'https://www.instagram.com/teamliquid', 'dotabuff': 'https://www.dotabuff.com/esports/teams/2163', 'datdota': 'https://www.datdota.com/teams/2163'}, 'cups': ['RaidCall Dota 2 League Season 2', 'EPICENTER 2016', 'StarLadder i-League StarSeries Season 3', 'StarLadder i-League Invitational Season 2', 'EPICENTER 2017', 'The International 2017', 'China Dota2 Supermajor', 'ESL One Germany 2020'], 'team_roster': [{'ID': 'miCKe', 'Name': 'Michael Vu', 'Position': '1', 'Join Date': '2019-10-02'}, {'ID': 'qojqva', 'Name': 'Maximilian Bröcker', 'Position': '2', 'Join Date': '2019-10-02'}, {'ID': 'Boxi', 'Name': 'Samuel Svahn', 'Position': '3', 'Join Date': '2019-10-02'}, {'ID': 'Taiga', 'Name': 'Tommy Le', 'Position': '4', 'Join Date': '2019-10-02'}, {'ID': 'iNSaNiA', 'Name': 'Aydin Sarkohi', 'Position': '5', 'Join Date': '2019-10-02'}]} ````team_details = dota_obj.get_team_info('Team Liquid',True)gets all transfers from Portal:Transfers
[{'Date': '2018-12-03', 'Player': ['Moogy', 'Inflame'], 'Previous': 'Newbee', 'Current': 'Newbee'},...{'Date': '2018-09-10', 'Player': ['Fenrir'], 'Previous': 'Vici Gaming', 'Current': 'Team Aster'}]transfers = dota_obj.get_transfers()gets all matches from Liquipedia:Upcoming_and_ongoing_matches
[{'team1': 'B8', 'format': 'Bo3', 'team2': 'EXTREMUM', 'start_time': 'January 11, 2021 - 10:00 UTC', 'tournament': 'ESL One CIS Online Season 1: Decider Tournament', 'tournament_short_name': 'ESL One CIS S1: Decider', 'twitch_channel': None},...,{'team1': 'NoPangolier', 'format': 'Bo3', 'team2': 'Winstrike Team', 'start_time': 'January 11, 2021 - 13:00 UTC', 'tournament': 'ESL One CIS Online Season 1: Decider Tournament', 'tournament_short_name': 'ESL One CIS S1: Decider', 'twitch_channel': None}]games = dota_obj.get_upcoming_and_ongoing_games()gets all heros from Portal:Heroes
[{'image': 'https://liquipedia.net/commons/images/thumb/f/fa/Abaddon_Large.png/125px-Abaddon_Large.png', 'name': 'Abaddon'},...,{'image': 'https://liquipedia.net/commons/images/thumb/9/91/Zeus_Large.png/125px-Zeus_Large.png', 'name': 'Zeus'}]heros = dota_obj.get_heros()gets all items from Portal:Items
[{'image': 'https://liquipedia.net/commons/images/thumb/c/cd/Animal_Courier.png/60px-Animal_Courier.png', 'name': 'Animal Courier', 'price': '50'},...,{'image': 'https://liquipedia.net/commons/images/thumb/e/ e8/Ring_of_Aquila.png/60px-Ring_of_Aquila.png', 'name': 'Ring of Aquila', 'price': '985'}]items = dota_obj.get_items()gets all patches from Portal:Patches
[{'Version': '7.20c', 'Release Date': '2018-11-24', 'Highlights': ['Balance Changes']},...,{'Version': '0.60', 'Highlights': ['Ported the following heroes:', ' Chen', ' Crystal Maiden', ' Death Prophet', ' Doom', ' Drow Ranger', ' Faceless Void', ' Lich', ' Lina', ' Lion', ' Magnus', " Nature's Prophet", ' Nyx Assassin', ' Pugna', ' Queen of Pain', ' Razor', ' Riki', ' Shadow Shaman', ' Silencer', ' Slardar', ' Sven', ' Vengeful Spirit', ' Venomancer', ' Viper', ' Visage', ' Wraith King']}]patches = dota_obj.get_patches()gets all tournaments from Portal:Tournaments
| Param | Type | Description |
|---|---|---|
| type | string |
type of tournaments , defaults to None , accepted values are Tier 1 ,Tier 2, Tier 3, Tier 4, Qualifier, Monthly, Weekly, Show Matches |
[{'tier': 'Qualifier', 'name': 'DreamLeague Season 14 DPC EU Decider Tournament', 'icon': 'https://liquipedia.net/commons/images/9/96/Dreamleague_logo_small.png', 'page': 'https://liquipedia.net/dota2/Dota_Pro_Circuit/2021/1/Europe/Decider_Tournament', 'dates': 'Jan 07 - 10, 2021', 'prize_pool': 0, 'teams': '8', 'host_location': 'Europe', 'winner': 'TBD', 'runner_up': 'TBD'},...,{'tier': 'Tier 4', 'name': 'Moscow Esports 2020 S2 Superfinal', 'icon': 'https://liquipedia.net/commons/images/b/b6/Moscowesport.png', 'page': 'https://liquipedia.net/dota2/Moscow_Esports/7', 'dates': 'Dec 19 - 20, 2020', 'prize_pool': 2039, 'teams': '16', 'host_location': 'Russia', 'winner': 'Blstrbl', 'runner_up': 'NP'}]tournaments = dota_obj.get_tournaments()gets baner url from tournament page
| Param | Type |
|---|---|
| url | string |
'https://liquipedia.net/commons/images/thumb/0/0b/IeSF_2020.png/600px-IeSF_2020.png'tournaments = dota_obj.get_tournament_baner('https://liquipedia.net/dota2/IeSF_World_Championship/2020')returns pro circuit rankings and schedule
{'rankings': [{'#': '1.', 'ID': ' Virtus.pro', 'Points': ' 4950', 'DreamLeague Season 10': 0, 'The Kuala Lumpur Major': ' 4950', 'The Bucharest Minor': 0, 'The Chongqing Major': 0, 'TBD': 0, 'DreamLeague Season 11': 0, 'AMD SAPPHIRE Dota PIT Minor': 0},...{'#': '23.', 'ID': ' ROOONS', 'Points': ' 8.192 5', 'DreamLeague Season 10': ' 20', 'The Kuala Lumpur Major': 0, 'The Bucharest Minor': 0, 'The Chongqing Major': 0, 'TBD': 0, 'DreamLeague Season 11': 0, 'AMD SAPPHIRE Dota PIT Minor': 0}], 'schedule': [{'Date': 'Sep 16-21, 2018', 'Title': ' The Kuala Lumpur Major Qualifier', 'DPC Points': '0'},...,{'Date': 'June 20-30, 2019', 'Title': 'Major Main Event', 'DPC Points': '15000'}]}pro_circuit_details = dota_obj.get_pro_circuit_details()create a counterstike object
| Param | Type | Description |
|---|---|---|
| appname | string |
The name for your app, you can refer to the liquipedia's terms of use for more information |
from liquipediapy import counterstrike
counterstrike_obj = counterstrike("appname")returns all counter-strike players from all regions from Portal:Players
[{'id': 'MITSARAS', 'name': 'DimitrisFiloxenidis', 'country': 'Austria', 'team': 'Private Esports'},..., {'id': 'takbok', 'name': 'JanTheron', 'country': 'South Africa', 'team': ''}]players = counterstrike_obj.get_players()returns all counter-strike teams from specified region
| Param | Type | Description |
|---|---|---|
| region | string |
region from which you want the teams you can find the regions on this page tabs |
[{'name': 'Astralis', 'logo': 'https://liquipedia.net/commons/images/3/37/Astralislogo_std.png', 'playes': [{'country': 'Denmark', 'id': 'dev1ce', 'name': ' Nicolai Reedtz '}, {'country': 'Denmark', 'id': 'dupreeh', 'name': ' Peter Rasmussen '}, {'country': 'Denmark', 'id': 'Xyp9x', 'name': ' Andreas Højsleth '}, {'country': 'Denmark', 'id': 'gla1ve', 'name': ' Lukas Rossander '}, {'country': 'Denmark', 'id': 'Magisk', 'name': ' Emil Reif '}, {'country': 'Denmark', 'id': 'zonic', 'name': ' Danny Sørensen '}]},...,{'name': 'x6tence', 'logo': 'https://liquipedia.net/commons/images/b/b4/X6tencelogo_std.png', 'playes': [{'country': 'Spain', 'id': 'FlipiN', 'name': ' Antonio Rivas del Rey '}, {'country': 'Argentina', 'id': 'JonY BoY', 'name': ' Jonathan Muñoz '}, {'country': 'Spain', 'id': 'TheClaran', 'name': ' Carlos Gonzálvez '}, {'country': 'Spain', 'id': 'Meco', 'name': ' Sebastián Meco '}, {'country': 'Spain', 'id': 'Vares', 'name': ' Luis Olivares '}, {'country': 'Spain', 'id': 'FeldmaN', 'name': ' Rafael Rodríguez '}, {'country': 'Spain', 'id': 'Hepa', 'name': ' Juan Borges '}, {'country': 'Spain', 'id': 'TiburoN', 'name': ' Miguel Agudo Sánchez '}, {'country': 'Spain', 'id': 'Alexsen', 'name': ' Alejandro Alberto Gesteira '}, {'country': 'Spain', 'id': 'Xeon', 'name': ' Carles García '}]}]teams = counterstrike_obj.get_teams()gets information for a specified player
| Param | Type | Description |
|---|---|---|
| playerName | string |
name of player |
| results | bool |
if you want to parse the results page for the player, defauls to False |
{'info': {'image': 'https://liquipedia.net/commons/images/thumb/5/51/Nitr0_at_StarLadder_i-League_StarSeries_S4.jpg/600px-Nitr0_at_StarLadder_i-League_StarSeries_S4.jpg', 'name': 'Nicholas Cannella', 'birth_details': 'August 16, 1995 (1995-08-16) (age 23)', 'countries': ['United States'], 'status': 'Active', 'team': 'Team Liquid', 'roles': ['In-game leader', 'AWPer'], 'earnings': 403482, 'games': ['Global Offensive']}, 'links': {'twitter': 'https://twitter.com/nitr0',...'steamcommunity': 'https://steamcommunity.com/profiles/76561197995889730'},'history': [{'duration': '2014-04-08 – 2014-10-16', 'name': 'Area 51 Gaming'},...{'duration': '2015-01-13 – Present', 'name': 'Team Liquid'}],'achivements': [{'Date': '2018-12-09', 'Placement': '22', 'Tier': 'Premier', 'game': 'Counter-Strike: Global Offensive', 'Tournament': 'ESL Pro League Season 8 - Finals', 'Team': 'Team Liquid', 'Result': '1 : 3', 'opponent': 'Astralis', 'Prize': '$110,000'},...{'Date': '2016-07-10', 'Placement': '22', 'Tier': 'Premier', 'game': 'Counter-Strike: Global Offensive', 'Tournament': 'ESL One: Cologne 2016', 'Team': 'Team Liquid', 'Result': '0 : 2', 'opponent': 'SK Gaming', 'Prize': '$150,000'}],'gear_settings': {'hardware': {'Mouse': 'ZOWIE by BenQ EC2-B', 'Mousepad': 'Zowie G-SR (Dark Grey Edition)', 'Monitor': 'ZOWIE by BenQ XL2546', 'Refresh rate': '240 Hz', 'In-game resolution': '1024×768', 'Scaling': 'Black Bars', 'Keyboard': 'MK Disco (TKL)', 'Headset': 'HyperX Cloud II (Silver)'}, 'Mouse': {'Mouse': 'ZOWIE by BenQ EC2-B', 'Effective DPI': '700', 'cm/360': '59.4', 'in/360': '23.4', 'DPI': '400', 'In-game sens.': '1.75', 'Windows sens.': '6/11', 'Accel.': '1.05', 'Raw input?': 'On', 'Polling rate': '500 Hz'}, 'Crosshair': {'Style': '4', 'Size': '3', 'Thickness': '0.5', 'Sniper': '1', 'Gap': '-1', 'Outline': 'Yes (thickness 0)', 'Dot': 'No (0)', 'Color': 'Green (1)', 'Alpha': '255'}},'results': [{'Date': '2018-12-09', 'Placement': '22', 'Tier': 'Premier', 'game': 'Counter-Strike: Global Offensive', 'Tournament': 'ESL Pro League Season 8 - Finals', 'Team': 'Team Liquid', 'Result': '1 : 3', 'opponent': 'Astralis', 'Prize': '$110,000'},...,{'Date': '2014-06-22', 'Placement': '33', 'Tier': 'Minor', 'game': 'Counter-Strike: Global Offensive', 'Tournament': 'ESEA Season 16: Main Division - North America', 'Team': 'Area 51 Gaming', 'Result': '6 - 16', 'opponent': 'Mythic', 'Prize': '$800'}]}player_details = counterstrike_obj.get_player_info('nitr0',True)gets information for a specified team
| Param | Type | Description |
|---|---|---|
| teamName | string |
name of the team |
| results | bool |
if you want to parse the results page for the team, defauls to False |
{'info': {'image': 'https://liquipedia.net/commons/images/thumb/0/07/Team_liquid_logo_2017.png/600px-Team_liquid_logo_2017.png', 'location': ['Netherlands', 'North America'], 'region': ' North America', 'ceo': ' Victor "Nazgul" Goossens Steve "LiQuiD112" Arhancet', 'manager': ' Steve "jokasteve" Perino', 'team captain': ' Nicholas "nitr0" Cannella', 'coaches': ' Wilton "zews" Prado', 'sponsor': ['Alienware', 'Monster Energy', 'SAP', 'Twitch', 'HyperX', 'Ballistix', 'NEEDforSEAT'], 'earnings': 1971562, 'games': ['Global Offensive'], 'created': 'Organization: 2000-??-??: 2015-01-13'}, 'links': {'teamliquidpro': 'https://www.teamliquidpro.com/',...'steamcommunity': 'https://steamcommunity.com/groups/teamliquid-pro'},'team_roster': [{'Country': 'USA', 'ID': 'nitr0', 'Name': 'Nicholas Cannella', 'Join Date': '2015-01-13'},... {'Country': 'Brazil', 'ID': 'zews (Coach)', 'Name': 'Wilton Prado', 'Join Date': '2016-11-10'}],'achivements': [{'Date': '2018-12-09', 'Placement': '22', 'Tier': 'Premier', 'Type': 'Offline', 'game': 'Counter-Strike: Global Offensive', 'Tournament': 'ESL Pro League Season 8 - Finals', 'Results': '1:3', 'opponent': 'Astralis', 'Prize': '$110,000'},...,{'Date': '2016-07-10', 'Placement': '22', 'Tier': 'Premier', 'Type': 'Offline' 'game': 'Counter-Strike: Global Offensive', 'Tournament': 'ESL One: Cologne 2016', 'Results': '0:2', 'opponent': 'SK Gaming', 'Prize': '$150,000'}],'results': [{'Date': '2010-04-04', 'Placement': '1', 'Tier': 'B-Tier', 'Type': 'Offline', 'game': 'Counter-Strike', 'Tournament': 'Arbalet Ukraine 2010', 'Results': '2:0', 'opponent': 'PiNG', 'Prize': '$3,000'},...,{'Date': '2010-03-06', 'Placement': '1', 'Tier': 'S-Tier', 'Type': 'Offline', 'game': 'Counter-Strike', 'Tournament': 'Intel Extreme Masters IV', 'Results': '2:0', 'opponent': 'Fnatic', 'Prize': '$50,000'}]}team_details = counterstrike_obj.get_team_info('Team Liquid',True)gets all transfers from Portal:Transfers
[{'Date': '2018-12-16', 'Player': ['bnwGiggs'], 'Old': 'ALPHA Red', 'New': 'None'},...,{'Date': '2018-10-14', 'Player': ['fAst'], 'Old': 'Nemiga Gaming', 'New': 'None'}]transfers = counterstrike_obj.get_transfers()gets all matches from Liquipedia:Upcoming_and_ongoing_matches
[{'team1': 'Dragons Esports Club', 'team2': 'Giants Gaming', 'start_time': 'December 16, 2018 - 16:00 UTC', 'tournament': 'ESL Masters España S4', 'twitch_channel': 'esl csgo es'},...,{'team1': 'Team Endpoint', 'team2': 'Orgles5', 'start_time': 'January 5, 2019 - 16:00 UTC', 'tournament': 'Premiership Winter 2018', 'twitch_channel': None}]games = counterstrike_obj.get_upcoming_and_ongoing_games()gets all tournaments from Portal:Tournaments
| Param | Type | Description |
|---|---|---|
| type | string |
type of tournaments , defaults to None , accepted values are Premier ,Major, Minor , Monthly, Weekly |
[{'tier': 'Minor', 'tournament': 'WESG 2018 Female - Southeast Asia', 'date': 'Dec 13 - 16, 2018', 'prize': '$15,000', 'teams_no': '10', 'host_locaion': ' Malaysia', 'event_locaion': ' Kuala Lumpur', 'first_place': 'ArkAngel.fe', 'second_place': 'Asterisk'},...,{'tier': 'Qualifier', 'tournament': 'ESWC Africa 2018 - Nigerian Qualifier', 'date': 'Nov 17 - 18, 2018', 'prize': '', 'teams_no': '16', 'host_locaion': ' Nigeria', 'event_locaion': ' Online', 'qualified': []}]tournaments = counterstrike_obj.get_tournaments()gets all weapons from Portal:Weapons
[{'image': 'https://liquipedia.net/commons/images/4/4b/Weapon_hkp2000.png', 'name': 'P2000'},...,{'image': 'https://liquipedia.net/commons/images/a/ab/Weapon_knife_bowie.png', 'name': 'Bowie Knife'}]weapons = counterstrike_obj.get_weapons()gets information for a specified weapon
| Param | Type | Description |
|---|---|---|
| weaponName | string |
Name of the weapon you want information for |
{'image': 'https://liquipedia.net/commons/images/1/14/Weapon_CZ75-Auto.png', 'class': 'pistol', 'price': '$500', 'kill_award': '$50', 'ammunition/capacity': '12/12', 'reload_time': '2.7ss', 'movement_speed': '240 units/s', 'firing_mode': 'Automatic', 'side': ['Counter-Terrorists', ' Terrorists']}weapon_details = counterstrike_obj.get_weapon_info('CZ75-Auto')gets information from conter-strike statistics page
[{'name': ' Astralis', 'earnings': '$ 5,909,134', 'golds': '20', 'silver': '10', 'bronze': '2'},..., {'name': ' USSR Team', 'earnings': '$ 4,128', 'golds': '2', 'silver': '2', 'bronze': '2'}]statistics = counterstrike_obj.get_statistics()gets all patches from Patches
[{'Version': '1.36.6.9', 'Release Date': '14 December 2018', 'Release Highlights': ['Danger Zone Changes']},...{'Version': 'Beta 1.0', 'Release Date': '19 June 1999', 'Release Highlights': ['Initial Beta Release']}]patches = counterstrike_obj.get_patches()create a smash object
| Param | Type | Description |
|---|---|---|
| appname | string |
The name for your app, you can refer to the liquipedia's terms of use for more information |
from liquipediapy import counterstrike
smash_obj = smash("appname")
smash_obj = smash('appname', "F:\\Path\\To\\Debug\\Folder\\")returns all smash players from all regions from
- Players_(Americas)/64
- Players_(Americas)/Melee
- Players_(Americas)/Project_M
- Players_(Americas)/Brawl_WiiU_Ultimate
- Players_(Europe)/64
- Players_(Europe)/Melee
- Players_(Europe)/Project_M
- Players_(Europe)/Brawl_WiiU_Ultimate
- Players_(Asia/Oceania) Asia/Oceania page use dynamic tab instead of static tabs
[{'Country': 'Canada', 'ID': 'Fck Vwls', 'Real Name': 'Neil Mahadeo', 'Main': ['Captain Falcon'], 'Team': '', 'Links': {}, 'Game': '64'}, {'Country': 'Canada', 'ID': 'HandsomeTom', 'Real Name': 'Etienne Gagnon', 'Main': ['Kirby'], 'Team': '', 'Links': {'twitter': 'https://twitter.com/HandsomeTomSSB'}, 'Game': '64'},...,{'Country': 'Australia', 'ID': 'Waveguider', 'Real Name': 'Alex Grant', 'Main': ['Greninja', 'Wii Fit Trainer'], 'Team': '', 'Links': {'twitch': 'https://www.twitch.tv/waveguider', 'twitter': 'https://twitter.com/WaveguiderAU'}, 'Game': 'Brawl WiiU Ultimate'}]players = smash_obj.get_players()gets information for a specified player
| Param | Type | Description |
|---|---|---|
| playerName | string |
name of player |
| results | bool |
if you want to parse the results page for the player, defauls to False |
{'info': {'image': 'https://liquipedia.net/commons/images/thumb/5/5b/Armada_TBH8.jpg/600px-Armada_TBH8.jpg', 'name': 'Adam Lindgren', 'born': ' (1993-03-28) March 28, 1993 (age 29)', 'countries': ['Sweden'], 'years_active': '2007 - 2019', 'team': 'Alliance', 'earnings': 298358, 'nicknames': 'The Swedish Sniper, The Beast from Sweden, The One True God', 'current_mains': ' Inkling', 'secondaries': ' Corrin Mewtwo'}, 'links': {'www': 'https://www.reddit.com/user/Armada_', 'twitter': 'https://twitter.com/ArmadaUGS', 'facebook': 'https://facebook.com/armadassbm'},..., {'Game': 'Melee', 'Date': '2007-04-03', 'Place': ('D1', '4th'), 'Event': "Smashers' Reunion 2", 'Result': {'Characters': [], 'Scores': ['L'], 'Opp_characters': [], 'Opponent': 'Helios'}, 'Prize': {'amount': 49.0, 'currency': '$'}}]}player_details = smash_obj.get_player_info('Armada',True)returns all smash teams
['16-Bit Esports', '26 RISING', 'AllChat Esports', 'Alliance', 'Balance Gaming', 'Bandits Gaming', 'beastcoast', 'Bermuda', 'Black Sun E-Sports', 'BMS ESPORTS', 'BOX', 'Cologne Gaming Network', 'Chilly Mountain', 'CJ eSports', 'Clash Tournaments', 'Cloud9', 'Coalition Gaming', 'Conduit Gaming', 'Counter Logic Gaming', 'Crazy Raccoon', 'Dignitas', 'Divinity Esports', 'EndGameTV', 'Esport BERG', 'Even Matchup Gaming', 'Evil Geniuses', 'FaZe Clan', 'Fly Society', 'FlyQuest', 'FURIA Esports', 'Geeky Goon Squad', 'Golden Guardians', 'Granit Gaming', 'Ground Zero Gaming', 'Hexagon', 'Hound Esports', 'IlluZion Gaming', 'InControl Nation', 'Kanga Esports', 'Karnage eSports', 'Lavender esports', 'Level1', 'LOSC eSports', 'Luminosity Gaming', 'Mazer Gaming', 'Melee It On Me', 'Mindfreak', 'Moist Esports', 'Most Valuable Gaming', 'mYinsanity', 'Nevermore International', 'NidhoGG esport', 'orKs Grand Poitiers', 'Panda', 'Patchwork', 'Phenoms Pro', 'Phoenix Blue', 'Pittsburgh Knights', 'plan-B esports', 'Polar Ace', 'Pulse', 'Rectify Esports', 'Red Bull eSports', 'RELAPSE', 'Renegades', 'Revo', 'RoyalBlue eSports', 'Salty Arena', 'Shogunate Gaming', 'Sissi State Punks', 'SmartFox Gaming', 'Smash Studios', 'Solary', 'Spacestation Gaming', 'SSBMontreal', 'T1', 'Taipan Esports', 'The Dutch Brawlers', 'Team Envy', 'Heir', 'Team Liquid', 'Team Oplon', 'TSM', 'Team Vegacy', 'Tempo Storm', 'Thunder Gaming', 'UYU', 'VGBootCamp', 'Warthox', 'Wolves eSports', '24 Islands', '2GGaming', 'Amino', 'AntiBeat', 'Armada', 'Asterion', 'Beefy Smash Doods', 'Boreal eSports', 'COGnitive Gaming', 'Control Gaming', 'Dark Sided', 'Demise', 'Denial eSports', 'Dream Team', 'eSports Ecosystem', 'Earthroot Gaming', 'Echo Fox', 'eLevate', 'Empire Arcadia', 'FolloweSports.com', 'Forward Smash', 'Frequency Gaming', 'G2 Esports', 'Glacial Gaming', 'Halocline Gaming', 'Immortals', 'justice esports', 'Kingsmen', 'Kyoto eSports', 'LeStream Esport', 'LowLandLions', 'Meliora Esports', 'Mentality Esports', 'Misfits', 'Mortality', 'NRG Esports', 'OG', 'Obey Alliance', 'Phoenix1', 'Poilon Software', 'Prometheus', 'ROOT Gaming', 'Rogue', 'Selfless Gaming', 'ShieldBreakFast', 'Sinai Village', 'Sloth', 'Splyce', 'TKA E-Sports', 'Curse', 'Team Secret', 'Team YP', 'TeamViral', 'Tuxedo Esports', 'Versus Gaming Center', 'VwS Gaming', 'Winterfox', 'World Best Gaming', 'Yatta Gaming', 'eUnited']teams = smash_obj.get_teams()gets information for a specified team
| Param | Type | Description |
|---|---|---|
| teamName | string |
name of the team |
{'info': {'image': 'https://liquipedia.net/commons/images/thumb/4/4e/T1_allmode.png/600px-T1_allmode.png', 'location': ['South Korea', 'United States'], 'region': ' North America', 'created': '2019-03-13'}, 'links': {'t1': 'https://t1.gg', 'facebook': 'https://facebook.com/SKsports.T1', 'twitter': 'https://twitter.com/T1', 'www': 'https://www.youtube.com/channel/UCJprx3bX49vNl6Bcw01Cwfg'}, 'team_roster': [{'Country': 'South Korea', 'ID': 'Sejun', 'Name': 'Sejun Park', 'Main': ['King Dedede'], 'Join Date': '2019-11-14'}, {'Country': 'Mexico', 'ID': 'MKLeo', 'Name': 'Leonardo Lopez Perez', 'Main': ['Pyra and Mythra', 'Byleth'], 'Join Date': '2020-02-26'}, {'Country': 'United States', 'ID': 'ANTi', 'Name': 'Jason Bates', 'Main': ['Mario', 'Snake'], 'Join Date': '2019-04-17', 'Leave Date': '2020-07-02'}, {'Country': 'United States', 'ID': 'Larry Lurr', 'Name': 'Larry Holland', 'Main': ['Wolf', 'Falco'], 'Join Date': '2019-04-17', 'Leave Date': '2020-01-10'}], 'org_roster': []}team_details = smash_obj.get_team_info('T1')gets all transfers from Player_Transfers from Portal_Transfers/2014 to Portal_Transfers/2022
[{'Date': '2014-11-09', 'Player': [{'Country': 'Japan', 'Main': 'Sheik', 'Name': 'Nietono'}], 'Old': 'None', 'New': 'DetonatioN Gaming', 'Link': 'http://team-detonation.net/news/3709'},...,{'Date': '2022-01-01', 'Player': [{'Country': 'Japan', 'Main': 'Corrin', 'Name': 'Ly'}, {'Country': 'Japan', 'Main': 'Link', 'Name': 'Rido'}, {'Country': 'Japan', 'Main': 'Falco', 'Name': 'MASA'}], 'Old': 'None', 'New': 'UNI Gaming', 'Link': 'https://twitter.com/uni_gaming_info/status/1477071164174389251'}]transfers = smash_obj.get_transfers()gets all tournaments from Portal:Tournaments
| Param | Type | Description |
|---|---|---|
| games | list[string] |
games we want to retrieve, defaults is ['64'], accepted values are 64, Melee, Brawl, Project_M, Wii_U, Ultimate |
| extended_infos | bool |
get type of tournaments (Major, Invitationnal, Double, ...), Winner & RunnerUp characters (for Majors only) |
[{'Game': '64', 'Tournament': 'Apex 2022', 'Date': 'Nov 18 - 20, 2022', 'Prize': {'amount': ' ', 'currency': ' '}, 'Players': '', 'Location': {'Country': 'United States', 'City': 'Secaucus'}, 'Winner': {'Country': '', 'Name': ''}, 'Runner-up': {'Country': '', 'Name': ''}},..., {'Game': '64', 'Tournament': '1st Kansai', 'Date': 'Mar 14, 2008', 'Prize': {'amount': ' ', 'currency': ' '}, 'Players': '46', 'Location': {'Country': 'Japan', 'City': 'Osaka'}, 'Winner': {'Country': 'Japan', 'Name': 'Ron'}, 'Runner-up': {'Country': 'Japan', 'Name': 'Tsukuru BOY'}}][{'Game': '64', 'Tournament': 'Apex 2022', 'Date': 'Nov 18 - 20, 2022', 'Prize': {'amount': ' ', 'currency': ' '}, 'Players': '', 'Location': {'Country': 'United States', 'City': 'Secaucus'}, 'Winner': {'Country': '', 'Name': ''}, 'Runner-up': {'Country': '', 'Name': ''}},..., {'Game': '64', 'Tournament': '1st Kansai', 'Date': 'Mar 14, 2008', 'Prize': {'amount': ' ', 'currency': ' '}, 'Players': '46', 'Location': {'Country': 'Japan', 'City': 'Osaka'}, 'Winner': {'Country': 'Japan', 'Name': 'Ron', 'Characters': ['Jigglypuff']}, 'Runner-up': {'Country': 'Japan', 'Name': 'Tsukuru BOY', 'Characters': ['Captain Falcon']}, 'Type': 'Major'}]tournaments = smash_obj.get_tournaments()
tournaments = smash_obj.get_tournaments(extended_infos=True)
tournaments = smash_obj.get_tournaments(games=['64', 'Melee', 'Brawl', 'Project_M', 'Wii_U', 'Ultimate'], extended_infos=True)Contributions are welcome. Please submit all pull requests the against master branch. Please check the Contributing Guidelines for more details. If you want to contribute but have no idea what to work towards please check the TODO file or Issues there should always be something there you can work towards. Thanks!
This project conforms to the CC-BY-SA 3.0 license as that is the License that all the text data on Liquipedia adhears to, for more information you can check out the Liquipedia Copyrights Page.
A lot of images you can download with this API have been provided to Liquipedia under separate licensing terms that may be incompatible with CC-BY-SA 3.0 license.
Liquipedia has a API Terms of Use page. The rate limits mentioned there have to be strictly followed, or bans will be issued by Liquipedias server administration.