Age Of Empires 2 Online

Posted on  by 

  • Age of Empires II is the sequel to Age of Empires I, a bestselling PC game. Age of Empires II allows you to play 13 different civilizations, each with different unique units and architecture. This guide is for beginner to moderate players. This guide is useless for advanced players who can easily beat a very hard computer.
  • Buy and install Age of Empires II HD (2013) on Steam Launch the game from steam, start a game and then exit Download and install voobly desktop client (and create an account).

If you can run Age of Empires II: The Age of Kings, you can run the expansion, provided you have the additional hard drive space: 50 MB for a minimal install or 200 MB for a full install. I recommend the full install for best performance. AOEII: The Conquerors is an expansion pack and requires Age of Kings to play.

TypeRatingLobby NameLocationServerStatus
RankEloCountryNameGamesWinsDrops
RankRatingNameGamesStreakWinsWin %Last Match (ended)

LeaderboardRankRatingHighest RatingGamesStreakLongest StreakWinsLossesDrops

It is always great to see what people are able to do with data. Currently testing an API to share the data collected by aoe2.net for anyone to use with their projects.

Strings

Request a list of strings used by the API.

Endpoint
/api/strings

Request Parameters

game (Required)
Game (Age of Empires 2:HD=aoe2hd, Age of Empires 2:Definitive Edition=aoe2de)
language (Optional, defaults to en)
Language (en, de, el, es, es-MX, fr, hi, it, ja, ko, ms, nl, pt, ru, tr, vi, zh, zh-TW)

Example Request

https://aoe2.net/api/strings?game=aoe2de&language=en

Leaderboard

Request the current leaderboards

Endpoint
/api/leaderboard

Request Parameters

game (Required)
Game (Age of Empires 2:Definitive Edition=aoe2de)
leaderboard_id (Required)
Leaderboard ID (Unranked=0, 1v1 Deathmatch=1, Team Deathmatch=2, 1v1 Random Map=3, Team Random Map=4)
start (Required)
Starting rank (Ignored if search, steam_id, or profile_id are defined)
count (Required)
Number of leaderboard entries to get (Must be 10000 or less))
search (Optional)
Name Search
steam_id (Optional)
steamID64 (ex: 76561199003184910)
profile_id (Optional)
Profile ID (ex: 459658)

Example Request

https://aoe2.net/api/leaderboard?game=aoe2de&leaderboard_id=3&start=1&count=1

Lobbies

Request all open lobbies

Endpoint
/api/lobbies

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:HD=aoe2hd, Age of Empires 2:Definitive Edition=aoe2de)

Example Request

Player Last Match

Request the last match the player started playing, this will be the current match if they are still in game

Endpoint
/api/player/lastmatch

Request Parameters

game (Required)
Game (Age of Empires 2:Definitive Edition=aoe2de)
steam_id (steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (steam_id or profile_id required)
Profile ID (ex: 459658)

Example Request

https://aoe2.net/api/player/lastmatch?game=aoe2de&steam_id=76561199003184910

Player Match History

Request the match history for a player

Endpoint
/api/player/matches

Request Parameters

game (Required)
Game (Age of Empires 2:Definitive Edition=aoe2de)
start (Required)
Starting match (0 is the most recent match)
count (Required)
Number of matches to get (Must be 1000 or less))
steam_id (steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (steam_id or profile_id required)
Profile ID (ex: 459658)
steam_ids (steam_id or profile_id required)
steamID64 (ex: 76561199003184910,76561198449406083)
profile_ids (steam_id or profile_id required)
Profile ID (ex: 459658,199325)

Example Request

https://aoe2.net/api/player/matches?game=aoe2de&steam_id=76561199003184910&count=5

Player Rating History

Request the rating history for a player

Endpoint
/api/player/ratinghistory

Request Parameters

game (Required)
Game (Age of Empires 2:Definitive Edition=aoe2de)
leaderboard_id (Required)
Leaderboard ID (Unranked=0, 1v1 Deathmatch=1, Team Deathmatch=2, 1v1 Random Map=3, Team Random Map=4)
start (Required)
Starting match (0 is the most recent match)
count (Required)
Number of matches to get (Must be 10000 or less))
steam_id (steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (steam_id or profile_id required)
Profile ID (ex: 459658)

Example Request

https://aoe2.net/api/player/ratinghistory?game=aoe2de&leaderboard_id=3&steam_id=76561199003184910&count=5

Matches

Online

Request matches after a specific time

Endpoint
/api/matches

Request Parameters

game
Game (Age of Empires 2:Definitive Edition=aoe2de)
count (Required)
Number of matches to get (Must be 1000 or less))
since (Optional)
Only show matches starting after timestamp (epoch)

Example Request

Age Of Empires 2 Online Multiplayer

https://aoe2.net/api/matches?game=aoe2de&count=10&since=1596775000

Match

Request details about a match

Endpoint
/api/match

Request Parameters

game (Required)
Game (Age of Empires 2:Definitive Edition=aoe2de)
uuid (uuid or match_id Required)
Match UUID
match_id (uuid or match_id Required)
Match ID

Example Request

https://aoe2.net/api/match?uuid=66ec2575-5ee4-d241-a1fc-d7ffeffb48b6

Number of Players Online

Number of players in game and an estimate of the number current playing multiplayer

Endpoint
/api/stats/players

Request Parameters

Age Of Empires 2 Online Multiplayer

game (Required)
Game (Age of Empires 2:HD=aoe2hd, Age of Empires 2:Definitive Edition=aoe2de)

Example Request

Rank

Request rank details about a player

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
leaderboard_id (Optional, defaults to 3)
Leaderboard ID (Unranked=0, 1v1 Deathmatch=1, Team Deathmatch=2, 1v1 Random Map=3, Team Random Map=4)
language (Optional, defaults to en) - not fully translated
Language (en, de, el, es, es-MX, fr, hi, it, ja, ko, ms, nl, pt, ru, tr, vi, zh, zh-TW)
flag (Optional, defaults to true)
Show player flag
search (search, steam_id or profile_id required)
Name Search, returns the highest rated player
steam_id (search, steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (search, steam_id or profile_id required)
Profile ID (ex: 459658)

Age Of Empires 2 online, free

Example Command

!addcom !rank $(urlfetch https://aoe2.net/api/nightbot/rank?leaderboard_id=3&search=$(querystring)&steam_id=76561199003184910&flag=false)

Example Responses

Opponent

Request rank details about a players most recent opponent (1v1 only)

Online

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
leaderboard_id (Optional, defaults to 3)
Leaderboard ID is used when search is defined, will find the highest rated player matching the search term (Unranked=0, 1v1 Deathmatch=1, Team Deathmatch=2, 1v1 Random Map=3, Team Random Map=4)
language (Optional, defaults to en) - not fully translated
Language (en, de, el, es, es-MX, fr, hi, it, ja, ko, ms, nl, pt, ru, tr, vi, zh, zh-TW)
flag (Optional, defaults to true)
Show player flag
search (search, steam_id or profile_id required)
Name Search, returns the highest rated player
steam_id (steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (steam_id or profile_id required)
Profile ID (ex: 459658)

Age Of Empires 2 Online Play

Example Command

!addcom !opponent $(urlfetch https://aoe2.net/api/nightbot/opponent?search=$(querystring)&steam_id=76561199003184910&flag=false)

Example Responses

Match

Request details about the current or last match

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
leaderboard_id (Optional, defaults to 3)
Leaderboard ID is used when search is defined, will find the highest rated player matching the search term (Unranked=0, 1v1 Deathmatch=1, Team Deathmatch=2, 1v1 Random Map=3, Team Random Map=4)
language (Optional, defaults to en) - not fully translated
Language (en, de, el, es, es-MX, fr, hi, it, ja, ko, ms, nl, pt, ru, tr, vi, zh, zh-TW)
color (Optional, defaults to true)
Show player colors
flag (Optional, defaults to false)
Show player flag
search (search, steam_id or profile_id required)
Name Search, returns the highest rated player
steam_id (steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (steam_id or profile_id required)
Profile ID (ex: 459658)

Example Command

!addcom !match $(urlfetch https://aoe2.net/api/nightbot/match?search=$(querystring)&steam_id=76561199003184910&color=false&flag=false)

Example Responses

Civs

Request civs from the current or last match

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
leaderboard_id (Optional, defaults to 3)
Leaderboard ID is used when search is defined, will find the highest rated player matching the search term (Unranked=0, 1v1 Deathmatch=1, Team Deathmatch=2, 1v1 Random Map=3, Team Random Map=4)
language (Optional, defaults to en) - not fully translated
Language (en, de, el, es, es-MX, fr, hi, it, ja, ko, ms, nl, pt, ru, tr, vi, zh, zh-TW)
search (search, steam_id or profile_id required)
Name Search, returns the highest rated player
steam_id (steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (steam_id or profile_id required)
Profile ID (ex: 459658)

Example Command

!addcom !civs $(urlfetch https://aoe2.net/api/nightbot/civs?search=$(querystring)&steam_id=76561199003184910)

Example Responses

Map

Request the current map name

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
leaderboard_id (Optional, defaults to 3)
Leaderboard ID is used when search is defined, will find the highest rated player matching the search term (Unranked=0, 1v1 Deathmatch=1, Team Deathmatch=2, 1v1 Random Map=3, Team Random Map=4)
language (Optional, defaults to en) - not fully translated
Language (en, de, el, es, es-MX, fr, hi, it, ja, ko, ms, nl, pt, ru, tr, vi, zh, zh-TW)
search (search, steam_id or profile_id required)
Name Search, returns the highest rated player
steam_id (steam_id or profile_id required)
steamID64 (ex: 76561199003184910)
profile_id (steam_id or profile_id required)
Profile ID (ex: 459658)

Age Of Empires 2 Online Purchase

Example Command

!addcom !map $(urlfetch https://aoe2.net/api/nightbot/map?search=$(querystring)&steam_id=76561199003184910)

Age Of Empires 2 Online Game

Example Responses

Coments are closed