OverviewHello and welcome. With these APIs you can build your own scripts around Alpha league - widgets for websites, standalone apps and so on.
We have the following constants:
Races: PROTOSS, TERRAN, ZERG, RANDOM
Leagues: GRANDMASTER, MASTER, DIAMOND, PLATINUM, GOLD, SILVER, BRONZE
The API uses GMT as the default timezone.
version 1.12January 24, 2019
◆ Added player endpoint with detailed ladder statistics
◆ Endpoints match and clan now have ladder statistics as well
version 1.11December 1, 2018
◆ Added 'id' and 'bnetaccount' properties to the players in match endpoint
version 1.10October 15, 2018
◆ Added upcomingmatches endpoint
◆ Fixed in-game game chat channel in 'match' endpoint
◆ Fixed 'matchday' property in 'match' endpoint
version 1.09October 11, 2018
◆ Added players endpoint
version 1.08October 7, 2018
◆ Fixed an issue with order of teams in playoffs array in tournament endpoint
version 1.07June 15, 2018
◆ Applied new order of teams in tournament endpoint
version 1.06June 3, 2018
◆ Fixed the array of playoffs matches in tournament endpoint
version 1.05May 15, 2018
◆ Added tournament endpoint
version 1.04October 13, 2017
◆ Added name of in-game chat channel to matches
version 1.03October 10, 2017
◆ Default datetime was changed to GMT from MSK
version 1.02September 09, 2017
◆ Added 'Battleground' mark for matches
version 1.01August 16, 2017
◆ Fixed an issue with lineups in match endpoint
version 1.0August 4, 2017
◆ First version contains match and clan endpoints
HelpIf you need any help with the APIs, join our Discord server and feel free to ask any questions in the #Dev channel.
ClanInformation about a clan including a list of team players. Currently we have 447 registered accounts.
MatchInformation about a match with some data of the players. Now we have 4893 matches in the database.
PlayerThe endpoint includes detailed information about a player, his/her battlenet account data, ladder statistics and a list of played matches on Alpha league.
There are 4524 players in the database. ID of the last one is 9707.
PlayersThis is a full list of all players registered in Alpha league. Currently we have 4524 players in the DataBase, so response of this endpoint is more than 1 MB of data. As a result, we do not have a "live request" on this page in order to prevent the page from crashing. But you can try this at https://alpha.tl/api?players.
TournamentInformation about a tournament.
Upcoming matchesList of the upcoming matches. It can be empty during a midseason.
Live example request: