# Epic Games Free Games API

> Current and upcoming free games on the Epic Games Store with dates, prices, images and store links

- Vendor: `epicgamesfreegamesapi` · version 1.0 · category Gaming · tags epic games api, free games api, epic store api, game giveaways api, video games api, game deals api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/epicgamesfreegamesapi
- This document: https://apiclay.com/docs/epicgamesfreegamesapi.md
- OpenAPI 3.1: https://apiclay.com/api/epicgamesfreegamesapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `epicgamesfreegamesapi`
- Updated: 2026-11-18

## About

## Epic Games Free Games API

The Epic Games Store's weekly free-game promotions: every game in the current promotion catalog with its title, description, publisher, original and discounted price, images, store page slug, and the start and end dates of current and upcoming free windows.

Data comes from **store.epicgames.com** (https://store.epicgames.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/free-games?country=US&amp;locale=en-US&amp;allowCountries=US`, then read `promotions.promotionalOffers` (free now) and `promotions.upcomingPromotionalOffers` (free next).

### Routes

#### GET `/free-games` - Free games
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| locale | query | string | no | Language, e.g. `en-US`, `de`, `fr`. |
| country | query | string | no | Store country for prices, e.g. `US`, `GB`, `IN`. |
| allowCountries | query | string | no | Same country code as `country`. |

Returns: `data.Catalog.searchStore.elements[]` with `title`, `description`, `seller.name`, `price.totalPrice` (`originalPrice`, `discountPrice`, `fmtPrice`), `keyImages[]`, `catalogNs.mappings[].pageSlug`, `promotions.promotionalOffers[]` / `upcomingPromotionalOffers[]` (`startDate`, `endDate`, `discountSetting.discountPercentage`).

### Caveats

- A game is free right now when its `promotionalOffers` has a window covering today with a 0% price.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by store.epicgames.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /free-games — Free games
- Gateway: `GET https://api.apiclay.com/v1/api/epicgamesfreegamesapi/free-games`
- Public query params: `locale` (string), `country` (string), `allowCountries` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/epicgamesfreegamesapi/free-games" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
