{"id":22452038,"url":"https://github.com/woctezuma/egs-15daysofgames","last_synced_at":"2025-08-02T00:32:36.860Z","repository":{"id":45344185,"uuid":"439662885","full_name":"woctezuma/egs-15DaysofGames","owner":"woctezuma","description":"Datamining of 15 Days of (free) Games at the Epic Games Store (EGS).","archived":false,"fork":false,"pushed_at":"2025-07-22T23:04:58.000Z","size":192,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-23T01:07:55.334Z","etag":null,"topics":["15daysofgames","datamining","egs","epic","epic-games","epic-games-launcher","epic-games-store","fortnite","free-game","free-games","games","graphql","metaverse"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/woctezuma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-18T16:29:35.000Z","updated_at":"2025-07-22T23:05:01.000Z","dependencies_parsed_at":"2024-03-14T01:34:41.495Z","dependency_job_id":"a199a310-87c9-4368-918c-e1235ce46f77","html_url":"https://github.com/woctezuma/egs-15DaysofGames","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/woctezuma/egs-15DaysofGames","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woctezuma%2Fegs-15DaysofGames","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woctezuma%2Fegs-15DaysofGames/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woctezuma%2Fegs-15DaysofGames/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woctezuma%2Fegs-15DaysofGames/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/woctezuma","download_url":"https://codeload.github.com/woctezuma/egs-15DaysofGames/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woctezuma%2Fegs-15DaysofGames/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268317550,"owners_count":24231376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["15daysofgames","datamining","egs","epic","epic-games","epic-games-launcher","epic-games-store","fortnite","free-game","free-games","games","graphql","metaverse"],"created_at":"2024-12-06T06:09:36.517Z","updated_at":"2025-08-02T00:32:36.546Z","avatar_url":"https://github.com/woctezuma.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EGS: 15 Days of Games\n\n[![Build status with Github Action][build-image-action]][build-action]\n[![Code coverage][codecov-image]][codecov]\n[![Code Quality][codacy-image]][codacy]\n\nThis repository contains Python code to data-mine the 15 Days of (free) Games at the Epic Games Store (EGS).\n\n## Requirements\n\n-   Install the latest version of [Python 3.X][python-download-url].\n-   Install the required packages:\n\n```bash\npip install -r requirements.txt\n```\n\n## Usage\n\nTo download data of upcoming promotions:\n\n```bash\npython download_data.py\n```\n\nTo filter promotions to focus on potential free games:\n\n```bash\npython filter_promotions.py\n```\n\n### Work-In-Progress\n\n(Optional) To receive an Access Token for different Auth Clients, with or without an authorization code:\n\n```bash\npython check_auth.py\n```\n\nNB: cookie information is required to be able to receive a temporary authorization code from within Python.\n\n\u003cdetails\u003e\u003csummary\u003eHow to fill-in your cookie information\u003c/summary\u003e\n\u003cp\u003e\n\n1. Make sure you are connected to your [Epic Games][epic-games-store-login] account,\u003cbr/\u003e\n2. Visit [`epicgames.com/id/api/`][egs-cookie] to trigger the creation of a cookie value for `EPIC_BEARER_TOKEN`,\u003cbr/\u003e\n3. Press `\u003cShift-F9\u003e` in your web browser to access the storage section of the developer tools,\u003cbr/\u003e\n4. Use the filtering option to find the cookie value for `EPIC_BEARER_TOKEN`,\u003cbr/\u003e\n5. Copy-paste this cookie value into a new file called `data/personal_info.json`:\u003cbr/\u003e\n\n```json\n{\n  \"EPIC_BEARER_TOKEN\": \"PASTE_YOUR_COOKIE_VALUE_HERE\"\n}  \n```\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n## Results\n\nResults are shown [on the Wiki][wiki-results].\n\nA retrospective analysis of the results is conducted [on the homepage of the Wiki][wiki-retrospective-look].\n\nAn investigation of the leaks found online is conducted [on the Investigation page of the Wiki][wiki-investigation].\n\n## References\n\nAPI documentation:\n\n-   [`SD4RK/epicstore_api`][egs-api-python]: a Python wrapper for the EGS API,\n-   [`Tectors/EpicGraphql`][egs-api-graphql]: a documentation of GraphQL queries for the EGS API,\n-   [`MixV2/EpicResearch`][egs-api-clients]: a documentation of Auth Clients' name, id and secret,\n-   [`derrod/legendary`][egs-api-hosts]: a documentation of API hosts, along with access token management in [`api/egs.py`][egs-api-token],\n-   [`acidicoala/ScreamDB`][egs-web-app]: a web app to view EGS item ids,\n\nData leaks:\n\n-   [`egs-datamining`][egs-datamining]: datamining of Epic Games Store (EGS),\n-   [`geforce-leak`][geforce-leak]: datamining of Nvidia's GeForce NOW (GFN),\n\nGraphQL advice:\n\n-   A few [pieces of advice][wiki-graphQL] regarding GraphQL.\n\n\u003c!-- Definitions --\u003e\n\n[build-action]: \u003chttps://github.com/woctezuma/egs-15DaysofGames/actions\u003e\n[build-image-action]: \u003chttps://github.com/woctezuma/egs-15DaysofGames/workflows/Python application/badge.svg?branch=main\u003e\n\n[codecov]: \u003chttps://codecov.io/gh/woctezuma/egs-15DaysofGames\u003e\n[codecov-image]: \u003chttps://codecov.io/gh/woctezuma/egs-15DaysofGames/branch/main/graph/badge.svg\u003e\n\n[codacy]: \u003chttps://www.codacy.com/gh/woctezuma/egs-15DaysofGames\u003e\n[codacy-image]: \u003chttps://api.codacy.com/project/badge/Grade/3c06156df0dc4e26956e1dd9c17cb57b\u003e\n\n[python-download-url]: \u003chttps://www.python.org/downloads/\u003e\n[epic-games-store-login]: \u003chttps://www.epicgames.com/login\u003e\n[egs-cookie]: \u003c https://www.epicgames.com/id/api/redirect?clientId=319e1527d0be4457a1067829fc0ad86e\u0026responseType=code\u003e\n\n[wiki-results]: \u003chttps://github.com/woctezuma/egs-15DaysofGames/wiki/Upcoming-Promotions\u003e\n[wiki-graphql]: \u003chttps://github.com/woctezuma/egs-15DaysofGames/wiki/GraphQL\u003e\n[wiki-retrospective-look]: \u003chttps://github.com/woctezuma/egs-15DaysofGames/wiki\u003e\n[wiki-investigation]: \u003chttps://github.com/woctezuma/egs-15DaysofGames/wiki/Investigation\u003e\n\n[egs-api-python]: \u003chttps://github.com/SD4RK/epicstore_api\u003e\n[egs-api-graphql]: \u003chttps://github.com/Tectors/EpicGraphQL\u003e\n[egs-api-clients]: \u003chttps://github.com/MixV2/EpicResearch\u003e\n[egs-api-hosts]: \u003chttps://github.com/derrod/legendary\u003e\n[egs-api-token]: \u003chttps://github.com/derrod/legendary/blob/master/legendary/api/egs.py\u003e\n[egs-web-app]: \u003chttps://github.com/acidicoala/ScreamDB\u003e\n\n[egs-datamining]: \u003chttps://github.com/woctezuma/egs-datamining\u003e\n[geforce-leak]: \u003chttps://github.com/woctezuma/geforce-leak\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoctezuma%2Fegs-15daysofgames","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwoctezuma%2Fegs-15daysofgames","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoctezuma%2Fegs-15daysofgames/lists"}