Epic Games API: List free games
Lists current and upcoming free games on the Epic Games Store for a country, with giveaway dates, usual price, publisher, cover image and store link.
Unofficial. Not affiliated with or endorsed by Epic Games.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Country optional
country Country name or two-letter country code, such as United Kingdom or GB.
United States (default)
Input as JSON
{}Output
{ "games": [ { "title": "Home - A Unique Horror Adventure", "status": "Free now", "free_from": "2026-10-22T15:00:00+00:00", "publisher": "BancyCo", "free_until": "2026-10-29T15:00:00+00:00", "store_link": "https://store.epicgames.com/en-US/p/home-19212a" , "normal_price": 4.99, "currency_code": "USD", "cover_image_link": "https://cdn1.epicgames.com/spt-assets/46fc0cdb9f164a848e916249a8f68fc7/home-14ws1.png" }, { "title": "Sker Ritual", "status": "Free now", "free_from": "2026-10-22T15:00:00+00:00", "publisher": "Skybound Game Studios, Inc.", "free_until": "2026-10-29T15:00:00+00:00", "store_link": "https://store.epicgames.com/en-US/p/sker-ritual-aac702" , "normal_price": 24.99, "currency_code": "USD", "cover_image_link": "https://cdn1.epicgames.com/spt-assets/43d96f4437e34c87b7eff08831d1b1de/sker-ritual-1cyza.png" }, { "title": "Sorry We're Closed", "status": "Coming soon", "free_from": "2026-10-29T15:00:00+00:00", "publisher": "Akupara Games", "free_until": "2026-11-05T16:00:00+00:00", "store_link": "https://store.epicgames.com/en-US/p/sorry-were-closed-724c86" , "normal_price": 24.99, "currency_code": "USD", "cover_image_link": "https://cdn1.epicgames.com/spt-assets/9ab7eaaeb2f041969b350955b789f0f7/sorry-were-closed-16sj7.png" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"store.epicgames.com/list_free_games","input":{}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "store.epicgames.com/list_free_games" , "input": {}})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "store.epicgames.com/list_free_games" , "input": {} }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run store.epicgames.com/list_free_games# with {}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [], "properties": { "country": { "type": "string", "default": "United States", "description": "Country name or two-letter country code, such as United Kingdom or GB." } }}Output schema
{ "type": "object", "required": [ "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "required": [ "title", "status", "free_from", "free_until", "normal_price", "currency_code", "publisher", "cover_image_link", "store_link" ], "properties": { "title": { "type": [ "string", "null" ] }, "status": { "enum": [ "Free now", "Coming soon" ], "type": "string" }, "free_from": { "type": "string", "description": "ISO 8601 date-time with offset." }, "publisher": { "type": [ "string", "null" ] }, "free_until": { "type": "string", "description": "ISO 8601 date-time with offset." }, "store_link": { "type": [ "string", "null" ] }, "normal_price": { "type": [ "number", "null" ], "description": "Usual price in the local currency." }, "currency_code": { "type": [ "string", "null" ], "description": "Currency of the normal price." }, "cover_image_link": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "description": "Current free games first, then upcoming free games." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
store.epicgames.com/list_free_games- Returns
- title, status, free dates, usual price, publisher, cover image, store link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method store.epicgames.com/list_free_games with the inputs above.
Ask your agent
- What free games are available to claim on the Epic Games Store right now for United States players?
- Show me upcoming free giveaways on Epic with their dates and regular prices for GB.
- Which games are free this week on Epic in Germany, and who published them?
- Can you list the current and coming free titles in Canada, including store links and cover art?
- I'm in Japan. What free Epic Games Store titles can I grab, and when does each offer end?
See more
Lists PlayStation Store games and game editions currently on sale in a country, with prices and sale end dates. Add-ons and subscription-only offers are excluded.
store.playstation.com/list_dealsFinds an Xbox or PC game by name or by xbox.com store link. Returns its store details, prices and Game Pass availability for a country.
xbox.com/get_gameFinds current official-store prices, the all-time low and live bundles for a PC game in the selected country.
isthereanydeal.com/get_best_priceLooks up a PlayStation Store game by name or product link in a country. Prefers the standard full game; prices and offers vary by country. Game trials are not counted as PlayStation Plus inclusion.
store.playstation.com/get_gameLists the games with the most players on Steam right now, with current and peak players and prices for a chosen country.
store.steampowered.com/list_most_playedLists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates.
store.steampowered.com/list_top_sellersLists Xbox games currently on sale in a country, biggest discount first, with original and sale prices, sale end dates and Game Pass inclusion; console covers Xbox One and Xbox Series X|S. Reads the store's whole deals list and ranks it by discount.
xbox.com/list_dealsFinds a PC game on Steam by name, store link or app ID and returns its store details, country price, reviews, tags and live player count.
store.steampowered.com/get_game