GET /api/v0/players/:profile_id
GET /api/v0/players/:profile_id/games
page
(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_id
include_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/last
include_alts
(boolean, optional, whether to consider games from accounts linked on the aoe4world site)include_stats
(boolean, optional)GET /api/v0/players/search
query
(required, length >= 3)page
(integer, optional)GET /api/v0/players/autocomplete
leaderboard
(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/:leaderboard
page
(integer, optional)query
(string, optional)profile_id
(integer, optional)rm_1v1
as leaderboard, this temporarily redirects to rm_solo
, please update your app accordingly.
GET https://aoe4world.com/api/v0/games
page
(integer, optional, max: 20
)per_page
(string, optional, default: 50
)profile_ids
(integer, 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/stats/rm_solo/civilizations
patch
(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/matchups
patch
(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/maps
patch
(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/civilizations
patch
(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/matchups
patch
(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/maps
patch
(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/qm_2v2/civilizations
patch
(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/teams
patch
(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/civilizations
patch
(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/teams
patch
(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/civilizations
patch
(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
)