🎮 Epic Games Store Scraper

Scrape game listings, prices, discounts, promotions and free games from the Epic Games Store — no API key, no authentication required.

The scraper uses two techniques depending on the mode:

• Free games → direct public REST endpoint, instant, zero overhead
• Search / Browse / Product URLs → headless Chromium intercepts Epic's own GraphQL responses as the page loads, bypassing all server-side bot protection naturally

---

📦 What you get

Field	Description	Example
title	Game title	"Celeste"
seller	Store seller name	"Maddy Makes Games"
developer	Developer	"Maddy Makes Games"
publisher	Publisher	"Maddy Makes Games"
priceOriginal	Original formatted price	"$19.99"
priceDiscounted	Current sale price	"$9.99"
discountPercent	Discount %	50
isFree	Permanently free to play	false
isOnSale	Currently discounted	true
currency	Currency code	"USD"
releaseDate	Release date (ISO 8601)	"2018-01-25T00:00:00.000Z"
isCurrentlyFree	Active free promotion	false
isUpcomingFree	Scheduled free promotion	true
promotionStartDate	Promo start (ISO 8601)	"2026-04-10T15:00:00.000Z"
promotionEndDate	Promo end (ISO 8601)	"2026-04-17T15:00:00.000Z"
categories	Category paths	["games", "games/edition/base"]
tags	Genre/feature tags	["Platformer", "Indie", "Single Player"]
imageWide	Wide banner image URL	"https://cdn1.epicgames.com/..."
imageTall	Tall portrait cover URL	"https://cdn1.epicgames.com/..."
storeUrl	Full store page URL	"https://store.epicgames.com/en-US/p/celeste"

---

🚀 Modes

🎁 Free Games (recommended starting point)

Fetches all current and upcoming free game promotions. Epic gives away games every week. This mode uses a direct public REST endpoint — no browser, runs in seconds.

{
  "mode": "free_games",
  "country": "US",
  "locale": "en-US"
}

Output fields specific to this mode:

• isCurrentlyFree: true — game is free right now, grab it before promotionEndDate
• isUpcomingFree: true — game will be free from promotionStartDate

---

🔍 Keyword Search

Find games matching one or more keywords. Each keyword runs as a separate search. Uses a headless browser to load the store page and capture the API response.

{
  "mode": "search",
  "searchQueries": ["cyberpunk", "souls-like", "city builder"],
  "country": "US",
  "maxResults": 50
}

---

📋 Browse Catalog

Paginate through Epic's full game catalog with optional filters.

{
  "mode": "browse",
  "category": "Game",
  "sortBy": "releaseDate",
  "sortDir": "DESC",
  "country": "US",
  "maxResults": 200
}

Browse on sale only:

{
  "mode": "browse",
  "onSaleOnly": true,
  "sortBy": "currentPrice",
  "sortDir": "ASC",
  "country": "US",
  "maxResults": 100
}

---

🔗 Specific Product URLs

Scrape exact product pages you provide.

{
  "mode": "product_urls",
  "startUrls": [
    { "url": "https://store.epicgames.com/en-US/p/celeste" },
    { "url": "https://store.epicgames.com/en-US/p/hades" },
    { "url": "https://store.epicgames.com/en-US/p/disco-elysium-the-final-cut" }
  ],
  "country": "US"
}

---

⚙️ Input parameters

Parameter	Type	Default	Description
mode	string	free_games	free_games, search, browse, product_urls
searchQueries	array	[]	Keywords for search mode
startUrls	array	[]	Product page URLs for product_urls mode
category	string	Game	Category filter for browse mode
sortBy	string	releaseDate	releaseDate, title, currentPrice, upcoming
sortDir	string	DESC	DESC or ASC
onSaleOnly	boolean	false	Return only discounted games
country	string	US	ISO country code for pricing
locale	string	en-US	Language locale
maxResults	integer	100	Max results total (0 = unlimited)
proxyConfiguration	object	disabled	Optional proxy (not required for standard use)

---

💡 Use cases

Weekly free game alerts — Schedule free_games mode to run daily. When isCurrentlyFree or isUpcomingFree changes, trigger a notification via webhook to Slack, Discord, or email.

Price intelligence across regions — Run with different country codes (US, TR, AR, BR, DE) to compare regional pricing. Epic's prices vary dramatically by region — Argentina and Turkey are commonly cheaper.

Sale tracking — Set onSaleOnly: true in browse mode and schedule weekly runs. Export to Google Sheets to track discount history over time.

Game catalog database — Run browse mode with maxResults: 0 to export Epic's entire catalog. Combine with Steam scraper data for cross-platform market analysis.

Competitor analysis — Search for specific publishers by name and monitor their catalog, pricing strategy, and promotions.

Deal newsletters — Combine free games + on-sale results and pipe the output to a newsletter automation via Make.com or Zapier.

---

📊 Sample output

{
  "title": "Celeste",
  "id": "b671fbc7be424e888c9346a9a6d3d9db",
  "seller": "Maddy Makes Games",
  "developer": "Maddy Makes Games",
  "publisher": "Maddy Makes Games",
  "priceOriginal": "$19.99",
  "priceDiscounted": "$19.99",
  "priceOriginalRaw": 1999,
  "discountPercent": 0,
  "isFree": false,
  "isOnSale": false,
  "currency": "USD",
  "releaseDate": "2018-01-25T05:00:00.000Z",
  "isCurrentlyFree": false,
  "isUpcomingFree": false,
  "categories": ["games", "games/edition/base", "applications"],
  "tags": ["Platformer", "Difficult", "Single Player", "Indie"],
  "imageWide": "https://cdn1.epicgames.com/b671fbc7be424e888c9346a9a6d3d9db/offer/Celeste-2560x1440.jpg",
  "storeUrl": "https://store.epicgames.com/en-US/p/celeste",
  "country": "US",
  "scrapedAt": "2026-04-05T12:00:00.000Z"
}

Free game example:

{
  "title": "Havendock",
  "priceOriginal": "$19.99",
  "priceDiscounted": "0",
  "discountPercent": 100,
  "isFree": false,
  "isCurrentlyFree": true,
  "isUpcomingFree": false,
  "promotionStartDate": "2026-03-26T15:00:00.000Z",
  "promotionEndDate": "2026-04-02T15:00:00.000Z",
  "storeUrl": "https://store.epicgames.com/en-US/p/havendock-64983e"
}

---

⚡ Performance & cost

Mode	Method	Speed	Cost estimate
free_games	REST (no browser)	~1 second	Minimal
search	Headless browser	~5s per keyword	Low
browse	Headless browser	~5s per 40 results	Low
product_urls	Headless browser	~5s per URL	Low

The headless browser approach is more resource-intensive than pure HTTP scraping but is the only reliable method that bypasses Epic's server-side API protection without requiring a paid proxy.

---

🔧 Technical notes

• Free games mode uses store-site-backend-static-ipv4.ak.epicgames.com/freeGamesPromotions — a stable public CDN endpoint used by many open-source projects
• Browser modes launch headless Chromium via Playwright, navigate to the Epic Store browse page, and intercept the GraphQL API response that the page itself fetches — no bot detection because it's a real browser making real requests
• Heavy resources (images, fonts, analytics, tracking) are blocked during browser sessions to reduce memory usage and speed up scraping
• A 1.5 second delay between pages is applied to avoid overwhelming Epic's servers
• Proxy is optional — the browser-based approach works without proxy for standard use. Enable Apify Residential Proxy only if you're running very large batch scrapes that trigger rate limits.