# Epic Games Store — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access data from store.epicgames.com.

**Category:** Entertainment | **Website:** [store.epicgames.com/](https://store.epicgames.com/) | **Docs:** [parse.bot/marketplace/998c0d4d-a8af-40eb-b6e2-5d146cecef2e/store-epicgames-com-api](https://parse.bot/marketplace/998c0d4d-a8af-40eb-b6e2-5d146cecef2e/store-epicgames-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_discounted_games

Browses the Epic Games Store catalog filtered to discounted games only (priceTier=tierDiscounted). Supports the same filtering, sorting, and pagination as browse_games. Returns paginated results with total count. Uses offset-based pagination via start parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter path. Common values: 'games/edition/base', 'Game', 'Apps'. |
| `count` | integer | No | Number of items to return per page. |
| `sort_by` | string | No | Sort field. |
| `sort_dir` | string | No | Sort direction. |
| `start` | integer | No | Pagination offset (0-based). |
| `tag` | string | No | Genre or tag filter identifier used by the Epic Games Store API. Omitting returns all discounted games. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/browse_discounted_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","count":"<integer>","sort_by":"<string>","sort_dir":"<string>","start":"<integer>","tag":"<string>"}'
```

### browse_games

Browses the Epic Games Store catalog with optional filtering and sorting. Returns paginated results with total count. Uses offset-based pagination via start parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter path. Common values: 'games/edition/base', 'Game', 'Apps'. |
| `count` | integer | No | Number of items to return per page. |
| `sort_by` | string | No | Sort field. |
| `sort_dir` | string | No | Sort direction. |
| `start` | integer | No | Pagination offset (0-based). |
| `tag` | string | No | Genre or tag filter identifier used by the Epic Games Store API. Omitting returns all games. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/browse_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","count":"<integer>","sort_by":"<string>","sort_dir":"<string>","start":"<integer>","tag":"<string>"}'
```

### get_discover_something_new

Returns games from the Discover Something New section on the Epic Games Store homepage. These are recently highlighted or newly released titles with pricing and badges.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_discover_something_new \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_free_games

Returns all currently free and upcoming free games from the Epic Games Store free games promotion page. Each game includes its status (FREE NOW or COMING SOON) and the promotional date range. The list refreshes weekly.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_free_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_free_games_coming_soon

Returns only games labeled COMING SOON from the Epic Games Store free games section. Filters out currently free games. Subset of get_free_games.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_free_games_coming_soon \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_free_games_now

Returns only games currently labeled FREE NOW from the Epic Games Store free games section. Filters out upcoming free games. Subset of get_free_games.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_free_games_now \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_game_details

Fetches full details for a specific game on the Epic Games Store by its URL slug. Returns description, pricing, genres, features, ratings, media gallery, and publisher info. Requires multiple GraphQL round-trips internally (mapping lookup, offer fetch, ratings).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_slug` | string | Yes | Product URL slug from the Epic Games Store product page URL (e.g. 'fortnite', 'ghostrunner-2'). Obtainable from the product_url field of other endpoints by extracting the last path segment after /p/. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_game_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_slug":"<string>"}'
```

### get_homepage_featured

Returns the hero/featured carousel items from the Epic Games Store homepage, including featured games, sales, and promotions with taglines and badges.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_homepage_featured \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news

Returns recent news articles and blog posts from the Epic Games Store news section. Each article includes title, summary, publication date, and URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_popular_genres

Returns popular game genre categories from the Epic Games Store browse page, including genre names, slugs, and representative images.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_popular_genres \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_top_new_releases

Returns games from the Top New Releases section on the Epic Games Store homepage. These are recently released titles curated by Epic.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/get_top_new_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_games

Searches for games by keyword in the Epic Games Store catalog. Returns up to 20 matching results sorted by relevancy.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'fortnite', 'action', 'racing'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-epicgames-com-api-998c0d4d/search_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```