Lodol Docs

Epic Games

API actions for the Epic Games integration.

Epic Games

Search for games, check free game giveaways, and look up product details in the Epic Games Store.


Get free games

Get the current free games from the Epic Games Store, along with when each promotion starts and ends.

Parameters

ParameterTypeRequiredDescription
countrystringNoTwo-letter country code that sets which region's promotions are shown (default US).
localestringNoLanguage and region for promotion text, for example en-US (the default).

Response

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

Get offer details

Look up detailed product information for a specific Epic Games Store offer.

Parameters

ParameterTypeRequiredDescription
product_slugstringYesThe short name from the product's store page web address, for example 'fortnite' in store.epicgames.com/p/fortnite.
localestringNoLanguage and region for page content, for example en-US (the default).

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).
localestringNoLanguage and region for results, for example en-US (the default).
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