# Epic Games Store API

> Epic Games Store returns free game listings, prices, ratings, and game details as a workflow and API.

Epic Games Store (EGS) lists current and upcoming free games by country, including giveaway dates and usual prices; it needs a country. Get game returns pricing, sale details, ratings, and game information by game name or store link, with optional country for pricing.

- Page: https://fous.com/tools/epic-games-store
- Handle: `@epic-games-store`
- Category: [Entertainment](https://fous.com/tools/category/entertainment)
- Source website: https://store.epicgames.com
- Last verified: Sep 29, 2026

## Methods

### Get game

Operation `get_game`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Look up an Epic Games Store game by name or store link, with current country-specific pricing, sale details, ratings and game information. Some games do not display a player or age rating.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `game` | string | yes | `"Alan Wake 2"` | Game name or Epic Games Store link, for example Alan Wake 2 or https://store.epicgames.com/en-US/p/alan-wake-2. |
| `country` | string | no | `"United Kingdom"` | Country name or two-letter code for pricing, for example United Kingdom or GB. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "game"
  ],
  "properties": {
    "game": {
      "type": "string",
      "description": "Game name or Epic Games Store link, for example Alan Wake 2 or https://store.epicgames.com/en-US/p/alan-wake-2.",
      "examples": [
        "Alan Wake 2",
        "https://store.epicgames.com/en-US/p/alan-wake-2",
        "Hades"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code for pricing, for example United Kingdom or GB.",
      "examples": [
        "United Kingdom"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "game": "Alan Wake 2"
    },
    {
      "game": "https://store.epicgames.com/en-US/p/alan-wake-2",
      "country": "United Kingdom"
    },
    {
      "game": "Hades"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `name` | string | `"Alan Wake 2"` |  |
| `genres` | array |  |  |
| `sale_end` | string or null | `"2026-10-06T18:00:00+00:00"` | Sale end date and time with UTC offset when discounted. |
| `developer` | string or null | `"Remedy Entertainment"` |  |
| `platforms` | array |  |  |
| `publisher` | string or null | `"Epic Games Publishing"` |  |
| `age_rating` | string or null | `"ESRB Mature 17+"` |  |
| `store_link` | string | `"https://store.epicgames.com/en-US/p/alan-wake-2"` |  |
| `release_date` | string or null | `"2023-10-27"` | Release date as YYYY-MM-DD. |
| `currency_code` | string | `"USD"` |  |
| `current_price` | number | `49.99` | Current price in the stated currency; zero when free. |
| `original_price` | number | `49.99` | Original price in the stated currency; zero when free. |
| `epic_product_id` | string or null | `"bb39232a9dab49969c3eb7fe994b2843"` |  |
| `cover_image_link` | string or null | `"https://cdn1.epicgames.com/offer/c4763f236d08423eb47b4c3008779c84/EGS_AlanWake2_RemedyEntertainment_S2_1200x1600-c7c809` |  |
| `discount_percent` | number | `0` |  |
| `epic_namespace_id` | string or null | `"c4763f236d08423eb47b4c3008779c84"` |  |
| `short_description` | string or null | `"Saga Anderson arrives to investigate ritualistic murders in a small town. Alan Wake pens a dark story to shape the real` |  |
| `epic_player_rating` | number or null | `4.8` | Epic player rating out of 5, when shown. |

**Example input**

```json
{
  "game": "Alan Wake 2"
}
```

**Example output**

```json
{
  "name": "Alan Wake 2",
  "genres": [
    "Horror",
    "Action-Adventure",
    "Shooter"
  ],
  "sale_end": null,
  "developer": "Remedy Entertainment",
  "platforms": [
    "Windows"
  ],
  "publisher": "Epic Games Publishing",
  "age_rating": "ESRB Mature 17+",
  "store_link": "https://store.epicgames.com/en-US/p/alan-wake-2",
  "release_date": "2023-10-27",
  "currency_code": "USD",
  "current_price": 49.99,
  "original_price": 49.99,
  "epic_product_id": "bb39232a9dab49969c3eb7fe994b2843",
  "cover_image_link": "https://cdn1.epicgames.com/offer/c4763f236d08423eb47b4c3008779c84/EGS_AlanWake2_RemedyEntertainment_S2_1200x1600-c7c8091ddac0f9669c8e5905bca88aaa",
  "discount_percent": 0,
  "epic_namespace_id": "c4763f236d08423eb47b4c3008779c84",
  "short_description": "Saga Anderson arrives to investigate ritualistic murders in a small town. Alan Wake pens a dark story to shape the reality around him. These two heroes are somehow connected. Can they become the heroe…",
  "epic_player_rating": 4.8
}
```

### List free games

Operation `list_free_games`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List current and upcoming free games on the Epic Games Store for a country, including giveaway dates, usual price, publisher, cover image, and store link. Availability varies by country.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no | `"United Kingdom"` | Country name or two-letter country code, such as United Kingdom or GB. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter country code, such as United Kingdom or GB.",
      "examples": [
        "United Kingdom",
        "JP"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {},
    {
      "country": "United Kingdom"
    },
    {
      "country": "JP"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `games` | array |  | Current free games first, then upcoming free games. |
| `games[].title` | string or null | `"Astrea Six Sided Oracles"` |  |
| `games[].status` | string | `"Free now"` |  |
| `games[].free_from` | string | `"2026-09-24T15:00:00+00:00"` | ISO 8601 date-time with offset. |
| `games[].publisher` | string or null | `"Akupara Games"` |  |
| `games[].free_until` | string | `"2026-10-01T15:00:00+00:00"` | ISO 8601 date-time with offset. |
| `games[].store_link` | string or null | `"https://store.epicgames.com/en-US/p/astrea-six-sided-oracles-33c949"` |  |
| `games[].normal_price` | number or null | `24.99` | Usual price in the local currency. |
| `games[].currency_code` | string or null | `"USD"` | Currency of the normal price. |
| `games[].cover_image_link` | string or null | `"https://cdn1.epicgames.com/spt-assets/4515173972ae4444a2582bc690c150bd/download-astrea-six-sided-oracles-offer-av5rc.pn` |  |

**Example input**

```json
{}
```

**Example output**

```json
{
  "games": [
    {
      "title": "Astrea Six Sided Oracles",
      "status": "Free now",
      "free_from": "2026-09-24T15:00:00+00:00",
      "publisher": "Akupara Games",
      "free_until": "2026-10-01T15:00:00+00:00",
      "store_link": "https://store.epicgames.com/en-US/p/astrea-six-sided-oracles-33c949",
      "normal_price": 24.99,
      "currency_code": "USD",
      "cover_image_link": "https://cdn1.epicgames.com/spt-assets/4515173972ae4444a2582bc690c150bd/download-astrea-six-sided-oracles-offer-av5rc.png"
    },
    {
      "title": "Mechabellum",
      "status": "Free now",
      "free_from": "2026-09-24T15:00:00+00:00",
      "publisher": "Dreamhaven, Inc.",
      "free_until": "2026-10-01T15:00:00+00:00",
      "store_link": "https://store.epicgames.com/en-US/p/mechabellum-88a843",
      "normal_price": 14.99,
      "currency_code": "USD",
      "cover_image_link": "https://cdn1.epicgames.com/spt-assets/131adc2288294d74aaff6a2f02b51d59/mechabellum-1jq5t.jpg"
    },
    {
      "title": "BURIED STARS",
      "status": "Coming soon",
      "free_from": "2026-10-01T15:00:00+00:00",
      "publisher": "LINE Games Corporation",
      "free_until": "2026-10-08T15:00:00+00:00",
      "store_link": "https://store.epicgames.com/en-US/p/buried-stars-d7c88c",
      "normal_price": 39.99,
      "currency_code": "USD",
      "cover_image_link": "https://cdn1.epicgames.com/spt-assets/e2dc55c2709641a18fc37ef7ce32cfdd/buried-stars-yijfe.png"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@epic-games-store",
  "visibility": "public",
  "operation": "get_game",
  "version": 1,
  "input": {
    "game": "Alan Wake 2"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@epic-games-store\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_game\",\n  \"version\": 1,\n  \"input\": {\n    \"game\": \"Alan Wake 2\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@epic-games-store",
  "visibility": "public",
  "operation": "get_game",
  "version": 1,
  "input": {
    "game": "Alan Wake 2"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/epic-games-store`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_game`: Get game. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_free_games`: List free games. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-epic-games-store https://api.fous.com/mcp/tools/epic-games-store --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track current and upcoming free game giveaways by country
- Compare current and original game prices
- Review game genres, platforms, publishers, and developers
- Check game ratings and sale end dates

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Epic Games Store tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Epic Games Store account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from store.epicgames.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### Which games are free now or coming soon?

List free games returns current and upcoming free games for a country, with giveaway dates and usual prices.

### What is a game's current price and discount?

Get game returns country-specific current and original prices, discount percentage, and sale end date when discounted.

### What platforms and ratings does a game have?

Get game returns game platforms and available player and age ratings.

## Related

- [Steam API](https://fous.com/tools/steam.md): Steam returns game details, country-specific prices, reviews, and current and historical player counts, plus player rankings and sales lists; some details or prices may be unavailable, and review totals span languages and verdicts.
- [PlayStation Store API](https://fous.com/tools/playstation-store.md): Find PlayStation Store game editions, prices, ratings, and release information, plus current game sales and their end dates where available.
- [Xbox API](https://fous.com/tools/xbox.md): Xbox provides game details, country-specific prices and Game Pass availability, catalog-ordered listings, and current country sales; prices may be unavailable and some dates unpublished.
- [Nintendo eShop API](https://fous.com/tools/nintendo-eshop.md): Nintendo eShop returns Nintendo Switch and Switch 2 game details and store prices by country, plus current game discounts in select countries, excluding downloadable add-ons.
- [Microsoft Store API](https://fous.com/tools/microsoft-store.md): Microsoft Store returns app and game listings, country-specific searches, and ranked charts; update notes, purchase prices, and exact rating counts may be unavailable.
- [Apple App Store API](https://fous.com/tools/apple-app-store.md): Apple App Store returns public app listings, keyword search, ratings, prices, listed purchases, country-specific reviews and visible replies, and up to 200 ranked chart apps.
- [IsThereAnyDeal API](https://fous.com/tools/isthereanydeal.md): Compare PC game prices at authorized stores.
- [Google Play API](https://fous.com/tools/google-play.md): Google Play helps people discover Android apps and games, view public listings and search results, read reviews when available by app and region, and see country-specific top charts.
- [All Entertainment tools](https://fous.com/tools/category/entertainment)