This repository contains Python code to data-mine achievements on the Epic Games Store (EGS).
- Install the latest version of Python 3.X.
- Install the required packages:
pip install -r requirements.txt
First, download the sandboxId
associated with every pageSlug
, via epic-games-ratings
.
python download_store_products.py
python download_sandbox_ids.py
The output is stored in:
data/sandbox_ids.json
NB: to distinguish base editions of games from DLC, it is recommended (but not mandatory) to keep a copy of:
data/store_data_0.json
data/store_data_1.json
Then, to retrieve the achievements associated with every sandboxId
, run:
python download_achievements.py
Finally, to export trimmed results to JSON and CSV, run:
python export_results.py
Alternatively:
A ranking of games sorted by number of players is available here.
Here is a description of the headers:
Game slug
is the ID of the game which appears in the Epic Games store URL,#players (EOS overlay)
is the number of players who have played with Epic Online Services in background,#completionists
is the number of players who have acquired all the achievements for the game,% of completionists
is the percentage of players who are completionists, described as "Platinum" on consoles,#players (estimate)
is an estimate of the number of players based on stats about completionists,#achievements
is the number of achievements of the game,Max % for an achievement
is the highest unlock rate among all the achievements of the game,Total XP
is the total number of experience points (XP) provided by game achievements ; 1000 XP are expected.
-
some games did not have achievements on release day, or had issues with the EOS overlay, so the number of players obtained via EOS should be considered as a lower-bound of the true number of players.
-
the percentage of completionists is rounded by Epic using one significant figure, so our estimate of the number of players via Platinum stats should be used with caution.
-
there are bugs. For instance, Aeon Must Die has a negative number of completionists.
-
if the total XP is zero, then achievements are planned, being implemented, or the studio tried but gave up.
-
if the highest unlock rate is 0%, then achievements are most likely broken for this game.
-
the total XP is not equal to 1000 XP for Alan Wake Remastered due to exceptional DLC achievements, for a total of 67 achievements (1500 XP) for the whole package, versus 50 achievements (1000 XP) for the base game.
-
the 100% unlock rate for an achievement ("Out of bed") of the game "Supraland" is not a bug: this achievement is obtained right at the start of the game.