# Epic Games Store Free Games API > Live free-games promotions from the Epic Games Store. The games that are free to claim right now (with the window they are free) and the ones becoming free soon — each with title, description, publisher, original price, store slug, cover image and store URL. The iconic "Epic free game this week" as a clean API for gaming, deal-alert, calendar and dashboard apps. Distinct from cross-store deal aggregators — Epic's own giveaways. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/epicgames-api/..." ``` ## Pricing - **Free** (Free) — 2,000 calls/Mo, 5 req/s - **Starter** ($7/Mo) — 50,000 calls/Mo, 10 req/s - **Pro** ($29/Mo) — 300,000 calls/Mo, 25 req/s - **Business** ($89/Mo) — 2,000,000 calls/Mo, 60 req/s ## Endpoints ### Free Games #### `GET /v1/free` — Games currently free on the Epic Games Store **Parameters:** - `country` (query, optional, string) — 2-letter ISO country code (default US) Example: `US` - `locale` (query, optional, string) — Locale (default en-US) Example: `en-US` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/epicgames-api/v1/free?country=US&locale=en-US" ``` **Response:** ```json { "data": { "note": "Games currently free to claim on the Epic Games Store (claim before free_end).", "count": 2, "games": [ { "url": "https://store.epicgames.com/en-US/p/the-ouroboros-king", "slug": "the-ouroboros-king", "image": "https://cdn1.epicgames.com/spt-assets/33630d7105014582a478094e89953f49/the-ouroboros-king-jwabx.jpg", "title": "The Ouroboros King", "free_end": "2026-06-18T15:00:00.000Z", "publisher": "Plug In Digital SAS", "free_start": "2026-06-11T15:00:00.000Z", "description": "The Ouroboros King combines the strategic depth of chess with the build variety and replayability of roguelikes. Assemble a formidable army, discover powerful relics, and buy surprising gadgets to defeat the Coven.", "original_price": "$9.99" }, { "url": "https://store.epicgames.com/en-US/p/b28e038bd68b4e80840e7fb8b747de54", "slug": "b28e038bd68b4e80840e7fb8b747de54", "image": "https://cdn1.epicgames.com/spt-assets/a1af14251fb748fc9bda63bfc260f933/warhammer-40k-speed-freeks-1k4pq.jpg", "title": "Warhammer 40K Speed Freeks", "free_end": "2026-06-18T15:00:00.000Z", "publisher": "Wired Productions", "free_start": "2026-06-11T15:00:00.000Z", "description": "Hig …(truncated, see openapi.json for full schema) ``` #### `GET /v1/upcoming` — Games becoming free on the Epic Games Store soon **Parameters:** - `country` (query, optional, string) — 2-letter ISO country code (default US) Example: `US` - `locale` (query, optional, string) — Locale (default en-US) Example: `en-US` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/epicgames-api/v1/upcoming?country=US&locale=en-US" ``` **Response:** ```json { "data": { "note": "Games becoming free on the Epic Games Store soon (free between free_start and free_end).", "count": 2, "games": [ { "url": "https://store.epicgames.com/en-US/p/da528841e0eb43d8b93fd243c6767b0c", "slug": "da528841e0eb43d8b93fd243c6767b0c", "image": "https://cdn1.epicgames.com/spt-assets/919d5976f3804d4cabb8ca90ea43a956/citizen-sleeper-xudwg.jpg", "title": "Citizen Sleeper", "free_end": "2026-06-25T15:00:00.000Z", "publisher": "Surprise Attack Pty Ltd DBA Fellow Traveller Games", "free_start": "2026-06-18T15:00:00.000Z", "description": "Roleplaying in the ruins of interplanetary capitalism. Live the life of an escaped worker, washed-up on a lawless station at the edge of an interstellar society. Inspired by the flexibility and freedom of TTRPGs, choose your friends, escape your past and change your future.", "original_price": "$19.99" }, { "url": "https://store.epicgames.com/en-US/p/4ee365fd76704f37ae3dc13676f1ac61", "slug": "4ee365fd76704f37ae3dc13676f1ac61", "image": "https://cdn1.epicgames.com/spt-assets/91105717b53044ed8e384e5fada71db8/robobeat-1ojda.png", "title": "ROBOBEAT", "free_end": "2026-06-25T15:00:00.000Z", "publisher": "Kwalee", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/epicgames-api/v1/meta" ``` **Response:** ```json { "data": { "note": "free = games free to claim now; upcoming = games free soon. Optional country (2-letter ISO, default US) and locale (default en-US) localise the offer window and prices.", "sample": { "first": "The Ouroboros King", "free_now": 2 }, "source": "Epic Games Store free-games promotions (live)", "service": "epicgames-api", "endpoints": { "GET /v1/free": "Games currently free on the Epic Games Store (country, locale).", "GET /v1/meta": "This document.", "GET /v1/upcoming": "Games becoming free on the Epic Games Store soon (country, locale)." }, "description": "Live free-games promotions from the Epic Games Store, keyless. The games that are free to claim right now (with the window they are free) and the ones becoming free soon — each with title, description, publisher, original price, store slug, cover image and store URL. The iconic 'Epic free game this week' as a clean API for gaming, deal-alert and calendar apps. Live, no key, nothing stored. Distinct from cross-store deal aggregators — Epic's own giveaways.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-14T08:04:40.356Z", "request_id": "fc9ef37b-fee4-4a0f-94ed-251d86bfa692" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/epicgames-api OpenAPI spec: https://www.oanor.com/api/epicgames-api/openapi.json