Offer Search

Use POST /search/v2/search for catalog search, filters, facets, regional prices, and pagination. Pass the visitor's ISO country code in the country query parameter so price filters, price sorts, and the returned price record use the corresponding Epic pricing region.

Technology Filters

Pass technologies as an array of non-empty detected build technology names. Values are trimmed, duplicates are ignored, and an offer must contain every selected technology:

POST /search/v2/search?country=US
Content-Type: application/json

{
  "technologies": ["Unreal", "NVIDIA_DLSS"],
  "page": 1,
  "limit": 25
}

Every response includes aggregations.technologies.buckets. Each bucket contains a technology name in key and the number of matching offers in doc_count. Counts are scoped to the request's active filters and count offers rather than individual platform builds.

Historical Lows

The following request returns the 25 most recently updated paid offers that are currently at their historical US low:

POST /search/v2/search?country=US
Content-Type: application/json

{
  "isLowestPriceEver": true,
  "price": { "min": 1 },
  "sortBy": "priceUpdatedAt",
  "sortDir": "desc",
  "page": 1,
  "limit": 25
}

isLowestPriceEver uses the API's US historical-low benchmark. The positive price.min excludes zero-price promotions. Price filtering, the returned regional price record, and priceUpdatedAt ordering use prices.<selected region> for the requested country. No offer-type filter is implied, so base games, editions, add-ons, DLC, and other offer types can be returned.

Regional Price Update Sort

Set sortBy to priceUpdatedAt to order offers by prices.<selected region>.updatedAt. Use sortDir: "desc" for the latest price changes first or sortDir: "asc" for the oldest first.