Package: liquipediapy
liquipediapyapi for liquipedia.netContentsInstallationExamplesAPIContributingAuthorLicenseNotesInstallpip install liquipediapyPlease refer toliquipedia's terms of usefor rate-limiting information.ExamplesTheexamplesdirectory contains an example files on how to interact with the each class.APIliquipediapyparsedota2webapisearchdotaget_playersget_player_infoget_team_infoget_transfersget_upcoming_and_ongoing_gamesget_herosget_itemsget_patchesget_tournamentsget_pro_circuit_detailscounterstrikeget_playersget_teamsget_player_infoget_team_infoget_transfersget_upcoming_and_ongoing_gamesget_tournamentsget_weaponsget_weapon_infoget_statisticsget_patchesliquipediapy(appname,game)create a liquipediapy objectparametersParamTypeDescriptionappnamestringThe name for your app, you can refer to theliquipedia's terms of usefor more informationgamestringname of the game you want to create the object forexamplefromliquipediapyimportliquipediapyliquipy_object=liquipediapy('appname')parse(page)parses a given pageexampleparametersParamTypeDescriptionpagestringname of the page you want to parseresponseReturnTypeDescriptionsoupbs4 Objectabeautifulsoupobjectredirect_valuestringif the page has been redirected then returns page value it was redirected to, orderwise returnsNoneexamplesoup,url=liquipediapy_object.parse('arteezy')dota2webapi(matchId)returns match details for a given dota2 match, only works ifgamevalue in contructor is set todota2exampleparametersParamTypeDescriptionmatchIdstringID of the match you want details forresponseReturnTypeDescriptionmatch_detailsjsonmatch_details if valid matchID otherwise an error in jsonexamplematch_details=liquipediapy_object.dota2webapi('4225454337')search(serach_value)searchs liquipedia.net for a given termexampleparametersParamTypeDescriptionserach_valuestringsearch termresponseReturnTypeDescriptionsearch_resultjsonresponseexamplesearch_result=liquipediapy_object.search('mar')dota(appname)create a dota objectparametersParamTypeDescriptionappnamestringThe name for your app, you can refer to theliquipedia's terms of usefor more informationexamplefromliquipediapyimportdotadota_obj=dota("appname")get_players()returns all dota players fromPortal:Playersresponse[{'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':{}}]exampleplayers=dota_obj.get_players()get_player_info(playerName,results)gets information for a specified playerparametersParamTypeDescriptionplayerNamestringname of playerresultsboolif you want to parse the results page for the player, defauls toFalseresponse{'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'}]}exampleplayer_details=dota_obj.get_player_info('Miracle-',True)get_team_info(teamName,results)gets information for a specified teamparametersParamTypeDescriptionteamNamestringname of the teamresultsboolif you want to parse the results page for the team, defauls toFalseresponse{'info':{'image':'https://liquipedia.net/commons/images/thumb/b/b6/Team_Liquid_2017_Vertical_Type.png/600px-Team_Liquid_2017_Vertical_Type.png','location':['Netherlands','Europe'],'region':'Europe','director':'NazgulSteve Arhancet','manager':'Mohamed Morad','team captain':'KuroKy','sponsor':['Monster',...,'Ballistix'],'earnings':17312752,'ranking':{'rank':'2','points':9459},'created':'2012-12-06'},'links':{'teamliquidpro':'https://www.teamliquidpro.com/',...,'datdota':'https://www.datdota.com/teams/2163'},'cups':['RaidCall Dota 2 League Season 2',...,'China Dota2 Supermajor'],'team_roster':[{'ID':'MATUMBAMAN','Name':'Lasse Urpalainen','Position':'1/2','Join Date':'2015-10-09'},...,{'ID':'KuroKy','Name':'Kuro Salehi Takhasomi','Position':'5','Join Date':'2015-10-09'}],'results':[{'Date':'2018-11-30','Placement':'22','LP Tier':'Qualifier','Tournament':'The Chongqing Major Europe Qualifier','Results':'2:1','opponent':'Alliance','Prize':'$0'},...,{'Date':'2013-02-10','Placement':'11','LP Tier':'Minor','Tournament':'BeyondTheSummit Weekend Cup','Results':'2:1','opponent':'Fnatic','Prize':'$500'}]}exampleteam_details=dota_obj.get_team_info('Team Liquid',True)get_transfers()gets all transfers fromPortal:Transfersresponse[{'Date':'2018-12-03','Player':['Moogy','Inflame'],'Previous':'Newbee','Current':'Newbee'},...{'Date':'2018-09-10','Player':['Fenrir'],'Previous':'Vici Gaming','Current':'Team Aster'}]exampletransfers=dota_obj.get_transfers()get_upcoming_and_ongoing_games()gets all matches fromLiquipedia:Upcoming_and_ongoing_matchesresponse[{'team1':'WP Gaming','format':'Bo3','team2':'Playmakers Esports','start_time':'December 5, 2018 - 2:00 UTC','tournament':'The Bucharest Minor SA Qual','twitch_channel':None},...,{'team1':'Doge (Singaporean team)','format':'Bo1','team2':'Casuals','start_time':'December 15, 2018 - 9:00 UTC','tournament':'SEL Season 2','twitch_channel':'sgpesports'}]examplegames=dota_obj.get_upcoming_and_ongoing_games()get_heros()gets all heros fromPortal:Heroesresponse[{'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'}]exampleheros=dota_obj.get_heros()get_items()gets all items fromPortal:Itemsresponse[{'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'}]exampleitems=dota_obj.get_items()get_patches()gets all patches fromPortal:Patchesresponse[{'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']}]examplepatches=dota_obj.get_patches()get_tournaments(type)gets all tournaments fromPortal:TournamentsparametersParamTypeDescriptiontypestringtype of tournaments , defaults toNone, accepted values arePremier,Major,Minor,Monthly,Weeklyresponse[{'tier':'Major','name':' The Bucharest Minor','icon':'https://liquipedia.net/commons/images/e/ed/The_Bucharest_Mihttps://github.com/c00kie17/liquipediapy/blob/master/CONTRIBUTING.mdnor_icon.png','dates':'Jan 9 - 13, 2019','prize_pool':300000,'teams':'8','host_location':'Romania','event_location':'Bucharest','links':[{'pglesports':'http://dota2.pglesports.com/'},...,{'twitter':'https://twitter.com/pglesports'}]},...,{'tier':'Qualifier','name':' The Bucharest Minor Southeast Asia Open Qualifier','icon':'https://liquipedia.net/commons/images/e/ed/The_Bucharest_Minor_icon.png','dates':'Dec 1 - 3, 2018','prize_pool':0,'teams':'82','host_location':'Southeast Asia','event_location':'Online','winner':' CG','runner_up':' WG.U'}]exampletournaments=dota_obj.get_tournaments()get_pro_circuit_details()returns pro circuitrankingsandscheduleresponse{'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'}]}examplepro_circuit_details=dota_obj.get_pro_circuit_details()counterstrike(appname)create a counterstike objectparametersParamTypeDescriptionappnamestringThe name for your app, you can refer to theliquipedia's terms of usefor more informationexamplefromliquipediapyimportcounterstrikecounterstrike_obj=counterstrike("appname")get_players()returns all counter-strike players from all regions fromPortal:Playersresponse[{'id':'MITSARAS','name':'DimitrisFiloxenidis','country':'Austria','team':'Private Esports'},...,{'id':'takbok','name':'JanTheron','country':'South Africa','team':''}]exampleplayers=counterstrike_obj.get_players()get_teams(region)returns all counter-strike teams from specified regionparametersParamTypeDescriptionregionstringregion from which you want the teams you can find the regions onthispage tabsresponse[{'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 '}]}]exampleteams=counterstrike_obj.get_teams()get_player_info(playerName,results)gets information for a specified playerparametersParamTypeDescriptionplayerNamestringname of playerresultsboolif you want to parse the results page for the player, defauls toFalseresponse{'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'}]}exampleplayer_details=counterstrike_obj.get_player_info('nitr0',True)get_team_info(teamName,results)gets information for a specified teamparametersParamTypeDescriptionteamNamestringname of the teamresultsboolif you want to parse the results page for the team, defauls toFalseresponse{'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','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','game':'Counter-Strike: Global Offensive','Tournament':'ESL One: Cologne 2016','Results':'0 : 2','opponent':'SK Gaming','Prize':'$150,000'}],'results':[{'Date':'2018-12-09','Placement':'22','Tier':'Premier','game':'Counter-Strike: Global Offensive','Tournament':'ESL Pro League Season 8 - Finals','Result':'1 : 3','opponent':'Astralis','Prize':'$110,000'},...,{'Date':'2015-01-25','Placement':'55 - 6','Tier':'Premier','game':'Counter-Strike: Global Offensive','Tournament':'MLG X Games Aspen Invitational','Result':'1/2','opponent':'Grp. S.','Prize':'$0'}]}exampleteam_details=counterstrike_obj.get_team_info('Team Liquid',True)get_transfers()gets all transfers fromPortal:Transfersresponse[{'Date':'2018-12-16','Player':['bnwGiggs'],'Old':'ALPHA Red','New':'None'},...,{'Date':'2018-10-14','Player':['fAst'],'Old':'Nemiga Gaming','New':'None'}]exampletransfers=counterstrike_obj.get_transfers()get_upcoming_and_ongoing_games()gets all matches fromLiquipedia:Upcoming_and_ongoing_matchesresponse[{'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}]examplegames=counterstrike_obj.get_upcoming_and_ongoing_games()get_tournaments(type)gets all tournaments fromPortal:TournamentsparametersParamTypeDescriptiontypestringtype of tournaments , defaults toNone, accepted values arePremier,Major,Minor,Monthly,Weeklyresponse[{'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':[]}]exampletournaments=counterstrike_obj.get_tournaments()get_weapons()gets all weapons fromPortal:Weaponsresponse[{'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'}]exampleweapons=counterstrike_obj.get_weapons()get_weapon_info(weaponName)gets information for a specified weaponparametersParamTypeDescriptionweaponNamestringName of the weapon you want information forresponse{'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']}exampleweapon_details=counterstrike_obj.get_weapon_info('CZ75-Auto')get_statistics()gets information from conter-strikestatisticspageresponse[{'name':' Astralis','earnings':'$ 5,909,134','golds':'20','silver':'10','bronze':'2'},...,{'name':' USSR Team','earnings':'$ 4,128','golds':'2','silver':'2','bronze':'2'}]examplestatistics=counterstrike_obj.get_statistics()get_patches()gets all patches fromPatchesresponse[{'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']}]examplepatches=counterstrike_obj.get_patches()ContributingContributions are welcome. Please submit all pull requests the against master branch. Please check theContributing Guidelinesfor more details. If you want to contribute but have no idea what to work towards please check theTODOfile orIssuesthere should always be something there you can work towards. Thanks!Authorc00kie17LicenseThis project conforms to theCC-BY-SA 3.0 licenseas that is the License that all the text data on Liquipedia adhears to, for more information you can check out theLiquipedia 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 withCC-BY-SA 3.0 license.NotesLiquipedia has aAPI Terms of Use page. The rate limits mentioned there have to be strictly followed, or bans will be issued by Liquipedias server administration.