Skip to content

woctezuma/egs-15DaysofGames

Repository files navigation

EGS: 15 Days of Games

Build status with Github Action Code coverage Code Quality

This repository contains Python code to data-mine the 15 Days of (free) Games at the Epic Games Store (EGS).

Requirements

  • Install the latest version of Python 3.X.
  • Install the required packages:
pip install -r requirements.txt

Usage

To download data of upcoming promotions:

python download_data.py

To filter promotions to focus on potential free games:

python filter_promotions.py

Work-In-Progress

(Optional) To receive an Access Token for different Auth Clients, with or without an authorization code:

python check_auth.py

NB: cookie information is required to be able to receive a temporary authorization code from within Python.

How to fill-in your cookie information

  1. Make sure you are connected to your Epic Games account,
  2. Visit epicgames.com/id/api/ to trigger the creation of a cookie value for EPIC_BEARER_TOKEN,
  3. Press <Shift-F9> in your web browser to access the storage section of the developer tools,
  4. Use the filtering option to find the cookie value for EPIC_BEARER_TOKEN,
  5. Copy-paste this cookie value into a new file called data/personal_info.json:
{
  "EPIC_BEARER_TOKEN": "PASTE_YOUR_COOKIE_VALUE_HERE"
}  

Results

Results are shown on the Wiki.

A retrospective analysis of the results is conducted on the homepage of the Wiki.

An investigation of the leaks found online is conducted on the Investigation page of the Wiki.

References

API documentation:

Data leaks:

GraphQL advice: