Home

AgeKeeper Wiki

AgeKeeper is a Python wrapper for the Age of Empires II public stats API, with a replay downloader and a replay scraper.

Start here

• Getting-Started-and-Usage
• Configuration-and-Data
• Architecture
• Troubleshooting
• Contributing
• Roadmap-and-Changelog

Project summary

• Download a replay ZIP by match ID, optionally unzip it.
• Fetch match details, player stats, recent matches, campaign stats, and leaderboard data.
• Use the API wrapper as a script or as a CLI.
• Scrape replay ranges with backoff and resume support.

Repo map

• aoe2api.py core API wrapper and CLI entry point.
• replay_scraper.py bulk replay scraping tool.
• replays/ default output folder for replay ZIPs and extracted files.
• scrape_state.txt resume state file for the scraper.
• assets/ project images and banner.