Lodol Docs

Epic Games

API actions for the Epic Games integration.

Epic Games

Browse and fetch offers from the Epic Games Store.


Get free games

Retrieve the current free games and their promotion window from the Epic Games Store.

Parameters

ParameterTypeRequiredDescription
countrystringNoTwo-letter country code used to localize promotions (default US).
localestringNoLocale code for localized promotion text (default en-US).

Response

{
  "current": [
    {
      "id": "free-123",
      "title": "Free Game Now"
    }
  ],
  "upcoming": [
    {
      "id": "free-456",
      "title": "Next Week Free"
    }
  ]
}

Get offer details

Fetch rich product details for a specific Epic Games Store offer by slug.

Parameters

ParameterTypeRequiredDescription
product_slugstringYesProduct slug or offer URL slug.
localestringNoLocale code for page content (default en-US).

Response

{
  "description": "A sample game description.",
  "id": "offer-123",
  "namespace": "ns-123",
  "price": {
    "totalPrice": {
      "discountPrice": 0
    }
  },
  "title": "Sample Game"
}

Search games

Search for games in the Epic Games Store catalog.

Parameters

ParameterTypeRequiredDescription
querystringYesKeyword to search for games or add-ons.
countrystringNoTwo-letter country code used for pricing (default US).
localestringNoLocale code for results (default en-US).
countnumberNoMaximum number of results to return (default 10).

Response

[
  {
    "id": "game-123",
    "namespace": "ns-123",
    "offer_type": "BASE_GAME",
    "title": "Sample Game"
  }
]

On this page