Game Type Elo Lobby Name Location Status
Type Rating Lobby Name Location Server Status
Ladder Rating Lobby Name Location Server Started
Rank Elo Country Name Games Wins Drops
Rank Rating Country Name Games Streak Wins Drops Last Match (ended)
Steam Avatar

Ladder Rank Rating Highest Rating Games Streak Longest Streak Wins Losses Drops

Ladder Rating Lobby Name Location Started

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.

At this time there are no limits to the number of requests, but please be considerate, and try to request only what you need, if performance of the site is affected limits will be added.


Strings

Request a list of strings used by the API.

Endpoint
/api/strings

Request Parameters

game (Optional, defaults to aoe2de)
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 (Optional, defaults to aoe2de)
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 (Optional)
Starting rank (Ignored if search, steam_id, or profile_id are defined)
count (Optional)
Number of leaderboard entries to get (Must be 1000 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

https://aoe2.net/api/lobbies?game=aoe2de

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 (Optional, defaults to aoe2de)
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

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)
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)

Example Command

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

Example Response

Hoang (1741) Rank #59, has played 1146 games with a 59% winrate, +2 streak, and 20 drops

Opponent

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

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
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)
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 !opponent $(urlfetch https://aoe2.net/api/nightbot/opponent?steam_id=76561198044559189)

Example Response

Villese (1512) Rank #1420, has played 172 games with a 74% winrate, +11 streak

Match

Request details about the current or last match

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
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)
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?steam_id=76561198044559189)

Example Response

_DauT_ (1952) as Slavs -VS- fixit (1812) as Slavs playing on Gold Rush

Civs

Request civs from the current or last match

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
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)
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?steam_id=76561198044559189)

Example Response

_DauT_: Slavs, fixit: Slavs

Map

Request the current map name

Request Parameters

game (Optional, defaults to aoe2de)
Game (Age of Empires 2:Definitive Edition=aoe2de)
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)
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 !map $(urlfetch https://aoe2.net/api/nightbot/map?steam_id=76561198044559189)

Example Response

Gold Rush

Powered by Steam

This site is not affiliated with or endorsed by Microsoft Corporation. Age of Empires II: HD and Age of Empires II: Definitive Edition are trademarks or registered trademarks of Microsoft Corporation in the U.S. and other countries.