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 Streak Wins Drops
Rank Rating Country Name Games Streak Wins Drops Last Match (ended)

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

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


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 (Optional)
Starting rank (Ignored if search or profile_id is defined)
count (Optional)
Number of leaderboard entries to get (Must be 1000 or less))
search (Optional)
Name Search
profile_id (Optional)
Profile ID

Example Request

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

Example Response

{
  "total": 17291,
  "leaderboard_id": 3,
  "start": 1,
  "count": 1,
  "leaderboard": [
    {
      "profile_id": 215442,
      "rank": 1,
      "rating": 2030,
      "steam_id": "76561198366260409",
      "icon": null,
      "name": "斗鱼前置龙",
      "clan": "NOPIG",
      "country": null,
      "previous_rating": 2015,
      "highest_rating": 2030,
      "streak": 15,
      "lowest_streak": -4,
      "highest_streak": 16,
      "games": 381,
      "wins": 276,
      "losses": 105,
      "drops": 4,
      "last_match": 1578851718
    }
  ]
}

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.