EGS: 15 Days of Games

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:

• SD4RK/epicstore_api: a Python wrapper for the EGS API,
• Tectors/EpicGraphql: a documentation of GraphQL queries for the EGS API,
• MixV2/EpicResearch: a documentation of Auth Clients' name, id and secret,
• derrod/legendary: a documentation of API hosts, along with access token management in api/egs.py,
• acidicoala/ScreamDB: a web app to view EGS item ids,

Data leaks:

• egs-datamining: datamining of Epic Games Store (EGS),
• geforce-leak: datamining of Nvidia's GeForce NOW (GFN),

GraphQL advice:

• A few pieces of advice regarding GraphQL.