GET /api/v0/players/:profile_idGET /api/v0/players/:profile_id/gamespage (integer, optional)limit (integer, optional)leaderboard (string, optional, allowed: rm_solo, rm_team, rm_1v1, rm_2v2, rm_3v3, rm_4v4, qm_1v1, qm_2v2, qm_3v3, qm_4v4)opponent_profile_id (integer, optional)since (integer | datetime string, optional)include_alts (boolean, optional, whether to consider games from accounts linked on the aoe4world site)api_key (string, optional, api key for private games)rm_solo, rm_team, qm_* etc) and game kinds (rm_1v1, rm_2v2, etc).GET /api/v0/players/:profile_id/games/:game_idinclude_alts (boolean, optional, whether to consider games from accounts linked on the aoe4world site)api_key (string, optional, api key for private games)GET /api/v0/players/:profile_id/games/lastinclude_alts (boolean, optional, whether to consider games from accounts linked on the aoe4world site)include_stats (boolean, optional)GET /api/v0/players/searchquery (required, length >= 3)page (integer, optional)GET /api/v0/players/autocompleteleaderboard (required, allowed: rm_solo, rm_team, qm_1v1, qm_2v2, qm_3v3, qm_4v4)query (required, length >= 3)limit (integer, optional, default: 10)rm_1v1 as leaderboard, this temporarily redirects to rm_solo, please update your app accordingly.
GET https://aoe4world.com/api/v0/leaderboards/:leaderboardpage (integer, optional)query (string, optional)country (string, optional, allowed: de, us, cn, fr etc)profile_id (alias profile_ids) (integer, comma separated up to 50 ids, optional)time (integer | datetime string, optional)rm_1v1 as leaderboard, this temporarily redirects to rm_solo, please update your app accordingly.time parameter can be used to show the rating, rank_level, max_rating, last_game_at at the specified time.
GET https://aoe4world.com/api/v0/gamespage (integer, optional, max: 20)per_page (string, optional, default: 50)profile_ids (integer, comma separated up to 50 ids, optional)leaderboard (string, optional, allowed: rm_1v1, qm_1v1, qm_2v2, qm_3v3, qm_4v4, rm_1v1_console, qm_1v1_console, qm_2v2_console, qm_3v3_console, qm_4v4_console)since (integer | datetime string, optional)updated_since (integer | datetime string, optional)order (string, optional, default: started_at, allowed: started_at, updated_at)leaderboard parameter type instead of actual leaderboards and thus doesn't support rm_solo nor rm_team. This may change later.
GET https://aoe4world.com/api/v0/esports/leaderboards/:leaderboardpage (integer, optional)query (string, optional)country (string, optional, allowed: de, us, cn, fr etc)show_inactive (boolean, optional, allowed: true, false, also shows inactive players)profile_id (alias profile_ids) (integer, comma separated up to 50 ids, optional)country isn't known for every player on the leaderboard, the list of 'official' tournament players is maintained manuallyliquipedia_name refers to how the player is commonly refered to on Liquipedia (https://liquipedia.net/ageofempires) and is also maintained manually, and the liquipedia page may or may not exist, and has to be manually updated if someone changes their name.is_active Whether the player has been active recently according to the leaderboardactive_rank What the player's rank would be if they were active (inactive players have can same rank as active ones based on their last known rating)
GET https://aoe4world.com/api/v0/stats/rm_solo/civilizationspatch (integer, optional, default: 10257, allowed: any, 9369, 10257, ..., see ui for list)rank_level (string, optional, allowed: bronze, silver, gold, platinum, diamond, conqueror, ≤silver, ≥gold, ≥platinum, ≥diamond, ≥conqueror, ≥conqueror_4)rating (string, optional, allowed: <499, 500-699, 700-999, 1000-1199, 1200-1399, <699, >700, >1000, >1200, >1400, >1700)GET https://aoe4world.com/api/v0/stats/rm_solo/matchupspatch (integer, optional, default: 10257, allowed: any, 9369, 10257, ..., see ui for list)rank_level (string, optional, allowed: bronze, silver, gold, platinum, diamond, conqueror, ≤silver, ≥gold, ≥platinum, ≥diamond, ≥conqueror, ≥conqueror_4)rating (string, optional, allowed: <499, 500-699, 700-999, 1000-1199, 1200-1399, <699, >700, >1000, >1200, >1400, >1700)GET https://aoe4world.com/api/v0/stats/rm_solo/mapspatch (integer, optional, default: 10257, allowed: any, 9369, 10257, ..., see ui for list)rank_level (string, optional, allowed: bronze, silver, gold, platinum, diamond, conqueror, ≤silver, ≥gold, ≥platinum, ≥diamond, ≥conqueror, ≥conqueror_4)rating (string, optional, allowed: <499, 500-699, 700-999, 1000-1199, 1200-1399, <699, >700, >1000, >1200, >1400, >1700)include_civs (boolean, optional, allowed: true, includes civ stats in the results, note that this is quite expensive, only use this if you need civ stats for each map)GET https://aoe4world.com/api/v0/stats/rm_solo/maps/:map_id (Get civ stats for specific map)patch, rank_level and rating as above
GET https://aoe4world.com/api/v0/stats/qm_1v1/civilizationspatch (integer, optional, default: 10257, allowed: any, 9369, 10257, ..., see ui for list)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)GET https://aoe4world.com/api/v0/stats/qm_1v1/matchupspatch (integer, optional, default: 10257, allowed: any, 9369, 10257, ..., see ui for list)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)GET https://aoe4world.com/api/v0/stats/qm_1v1/mapspatch (integer, optional, default: 10257, allowed: any, 9369, 10257, ..., see ui for list)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)include_civs (boolean, optional, allowed: true, includes civ stats in the results, note that this is quite expensive, only use this if you need civ stats for each map)GET https://aoe4world.com/api/v0/stats/qm_1v1/maps/:map_id (Get civ stats for specific map)patch and rating as above
GET https://aoe4world.com/api/v0/stats/rm_2v2/civilizationspatch (integer, optional, default: 10257, allowed: any, 9369, 10257)rank_level (string, optional, allowed: bronze, silver, gold, platinum, diamond, conqueror, ≤silver, ≥gold, ≥platinum, ≥diamond, ≥conqueror, ≥conqueror_4)rating (string, optional, allowed: <499, 500-699, 700-999, 1000-1199, 1200-1399, <699, >700, >1000, >1200, >1400, >1700)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)GET https://aoe4world.com/api/v0/stats/qm_2v2/teamspatch (integer, optional, default: 10257, allowed: any, 9369, 10257)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)GET https://aoe4world.com/api/v0/stats/rm_solo/mapspatch (integer, optional, default: 10257, allowed: any, 9369, 10257, ..., see ui for list)rank_level (string, optional, allowed: bronze, silver, gold, platinum, diamond, conqueror, ≤silver, ≥gold, ≥platinum, ≥diamond, ≥conqueror, ≥conqueror_4)rating (string, optional, allowed: <499, 500-699, 700-999, 1000-1199, 1200-1399, <699, >700, >1000, >1200, >1400, >1700)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)include_civs (boolean, optional, allowed: true, includes civ stats in the results, note that this is quite expensive, only use this if you need civ stats for each map)GET https://aoe4world.com/api/v0/stats/rm_2v2/maps/:map_id (Get civ stats for specific map)patch, rank_level and rating as aboveGET https://aoe4world.com/api/v0/stats/qm_2v2/civilizationspatch (integer, optional, default: 10257, allowed: any, 9369, 10257)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)GET https://aoe4world.com/api/v0/stats/qm_2v2/teamspatch (integer, optional, default: 10257, allowed: any, 9369, 10257)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)
GET https://aoe4world.com/api/v0/stats/qm_3v3/civilizationspatch (integer, optional, default: 10257, allowed: any, 9369, 10257)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)GET https://aoe4world.com/api/v0/stats/qm_3v3/teamspatch (integer, optional, default: 10257, allowed: any, 9369, 10257)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)
GET https://aoe4world.com/api/v0/stats/qm_4v4/civilizationspatch (integer, optional, default: 10257, allowed: any, 9369, 10257)rating (string, optional, allowed: <899, 900-999, 1000-1099, 1100-1199, 1200-1299, 1300-1399, >1100, >1200, >1300, >1400, >1500, >1600)