https://github.com/woctezuma/epic-games-ratings
Bayesian average ratings of games on the Epic Games store (EGS).
https://github.com/woctezuma/epic-games-ratings
bayesian-average datamining egs epic epic-games epic-games-launcher epic-games-store fortnite games games-list graphql metaverse ranking statistics
Last synced: 8 months ago
JSON representation
Bayesian average ratings of games on the Epic Games store (EGS).
- Host: GitHub
- URL: https://github.com/woctezuma/epic-games-ratings
- Owner: woctezuma
- License: mit
- Created: 2022-07-25T09:40:26.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-12-03T11:03:37.000Z (almost 2 years ago)
- Last Synced: 2025-02-01T17:12:36.504Z (10 months ago)
- Topics: bayesian-average, datamining, egs, epic, epic-games, epic-games-launcher, epic-games-store, fortnite, games, games-list, graphql, metaverse, ranking, statistics
- Language: Python
- Homepage:
- Size: 565 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Epic Games Ratings
[![Code Quality][codacy-image]][codacy]
This repository contains Python code to data-mine ratings at the Epic Games Store (EGS).
![Ranking of games based on the Bayesian average rating][img-cover]
## Disclaimer
The leak has been plugged, so the code cannot fetch `ratingCount` directly from Epic Games anymore.
> [!Note]
> As of December 15, 2022, the official ranking seems to be using Bayesian average ratings! 🥳🎉
>
> For comparison:
> - [the latest unofficial ranking][unofficial-ranking-latest], on September 24, 2022,
> - [the official ranking][official-ranking-new-sorting-order], on December 15, 2022.
> [!Note]
> Unfortunately, the official ranking was reverted back to using **raw** ratings later on the same day.
> [!Note]
> As of August 31, 2023, the official ranking uses a mysterious sorting order! 😱
>
> For investigation:
> - [the official ranking][official-ranking-mysterious-sorting-order-August-31-2023], on August 31, 2023,
> - [the official ranking][official-ranking-mysterious-sorting-order-September-01-2023], on September 1, 2023.
## Requirements
- Install the latest version of [Python 3.X][python-download-url].
- Install the required packages:
```bash
pip install -r requirements.txt
```
## Usage
To retrieve the `pageSlug` for every store product, run:
```bash
python download_store_products.py
```
Caveat: different store products can be associated with the same `pageSlug`, despite having different `title` values.
To retrieve the `sandboxId` associated with every `pageSlug`, run:
```bash
python download_sandbox_ids.py
```
To retrieve the ratings associated with every `sandboxId`, run:
```bash
python download_game_ratings.py
```
To export trimmed results to JSON and CSV, run:
```bash
python export_results.py
```
Alternatively:
- Run [`epic-games-ratings.ipynb`][colab-notebook]
[![Open In Colab][colab-badge]][colab-notebook]
## Results
A ranking of games sorted by Bayesian average rating is available [here][ranking-url].
NB: the ranking does not feature [delisted games][delisted-games].
## References
- Official ranking of [*Top Player Reviewed PC Titles*][egs-official-ranking], computed by Epic Games
- [`nikop/epic-games-ratings`][madjoki-egs-ratings]
- [`woctezuma/epic-games-achievements`][epic-games-achievements]
- [`woctezuma/epic-games-player-estimates`][epic-games-player-estimates]
- [`ToutinRoger/EpicGraphQL`][egs-api-graphql]
- [`woctezuma/Steam-Bayesian-Average`][Steam-Bayesian-Average]
- Bayesian average [on Wikipedia][bayes-wiki]
- Paul Masurel, [Of Bayesian average and star ratings][bayes-fulmicoton], March 2013
[img-cover]:
[codacy]:
[codacy-image]:
[python-download-url]:
[delisted-games]:
[madjoki-egs-ratings]:
[epic-games-achievements]:
[epic-games-player-estimates]:
[egs-api-graphql]:
[bayes-wiki]:
[bayes-fulmicoton]:
[Steam-Bayesian-Average]:
[colab-notebook]:
[colab-badge]:
[ranking-url]:
[egs-official-ranking]:
[unofficial-ranking-latest]:
[official-ranking-new-sorting-order]:
[official-ranking-mysterious-sorting-order-August-31-2023]:
[official-ranking-mysterious-sorting-order-September-01-2023]: