Skip to content

Configuration and Data

DiscantX edited this page Feb 7, 2026 · 2 revisions

Configuration and Data

This page merges configuration details and data storage.

Configuration

Edit defaults in aoe2api.py:

  • destination_folder where replay ZIPs are saved (default: replays).
  • game game key (default: age2).
  • profile_id default profile ID used in sample calls.
  • match_id default match ID used in sample calls.
  • match_type default match type for player stats and match list calls (default: 3).
  • unzip whether to unzip downloaded replay ZIPs (default: False).
  • remove_zip whether to delete the ZIP after extraction (default: False).
  • headers default headers for API requests.

Edit defaults in replay_scraper.py:

  • request_interval delay between requests in seconds.
  • back_off_delay base backoff delay when rate limited (seconds).
  • back_off_multiplier exponential backoff multiplier.
  • max_back_off_delay maximum backoff delay (seconds).
  • start_id starting match ID.
  • end_id ending match ID.
  • endpoint_name endpoint name to scrape.
  • unzip_replays whether to unzip downloaded replays.
  • remove_zip whether to delete ZIPs after extraction.
  • scrape_state_file scraper resume state file path.
  • resume whether to resume from the last state file.
  • count_backwards scrape from start_id down to end_id when True.

Data locations

  • replays/ default output for replay ZIPs and extracted files.
  • scrape_state.txt default resume state file.
  • assets/ project images.

Output behavior

  • Replay ZIPs are named {match_id}.zip.
  • If unzip is enabled, extracted files are placed in the same destination folder.

Clone this wiki locally