{
  "openapi": "3.0.1",
  "info": {
    "title": "Epic Games Store Scraper: Free Games & Product Data",
    "description": "Scrape the Epic Games Store free games feed: current and upcoming giveaways with exact promo start and end dates, original prices and store links for any country, plus product details with developer, publisher, tags and ratings. Export CSV, Excel, JSON, XML. No login or API key.",
    "version": "0.1",
    "x-build-id": "SYxDlEksCIqxqPthP"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/recordsdata~epic-games-store-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-recordsdata-epic-games-store-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/recordsdata~epic-games-store-scraper/runs": {
      "post": {
        "operationId": "runs-sync-recordsdata-epic-games-store-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/recordsdata~epic-games-store-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-recordsdata-epic-games-store-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "What do you want to scrape?",
            "enum": [
              "auto",
              "freeGames",
              "catalog",
              "both"
            ],
            "type": "string",
            "description": "Auto (default) returns this week's free games, or searches the catalogue if you set a search query or any filter below. Pick another option to force the free games feed, the catalogue search, or both in one run.",
            "default": "auto"
          },
          "countries": {
            "title": "Store countries",
            "type": "array",
            "description": "Two-letter storefront codes, one pass per code, for example US, GB, MX, ES, BR, DE. Every row carries its country, price and currency, so you can compare prices across countries.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "searchQuery": {
            "title": "Search keywords",
            "type": "string",
            "description": "Words to search in the catalogue, for example fallout or souls. Leave empty to browse with the filters below.",
            "default": ""
          },
          "catalogType": {
            "title": "Type of content",
            "enum": [
              "games",
              "dlc",
              "software",
              "all"
            ],
            "type": "string",
            "description": "Which store pages to search: games and bundles, DLC and add-ons, creator software, or everything.",
            "default": "games"
          },
          "sortBy": {
            "title": "Sort results by",
            "enum": [
              "relevance",
              "newest",
              "upcoming",
              "oldest",
              "priceAsc",
              "priceDesc",
              "nameAsc",
              "nameDesc",
              "recentlyUpdated",
              "biggestDiscount"
            ],
            "type": "string",
            "description": "Order of the catalogue results, applied by Epic before the row limit. Biggest discount returns only games on sale, best deals first.",
            "default": "relevance"
          },
          "genres": {
            "title": "Genres (optional)",
            "type": "array",
            "description": "Keep only games tagged with all of these genres, for example Action, RPG, Horror, Racing. Not case sensitive.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "platforms": {
            "title": "Platforms (optional)",
            "type": "array",
            "description": "Keep only games on these platforms: Windows or Mac OS.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyOnSale": {
            "title": "Only games on sale",
            "type": "boolean",
            "description": "Return only offers priced below the list price. Discount percent, amount and sale end date are in the output.",
            "default": false
          },
          "minDiscountPercent": {
            "title": "Min discount (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Only offers with at least this discount, for example 50. Also limits the search to games on sale."
          },
          "minPrice": {
            "title": "Min price (store currency)",
            "minimum": 0,
            "type": "number",
            "description": "Only offers priced at or above this amount, in the main unit of each storefront currency (10 means $10 in the US). Use 0 with Max price 0 for free offers."
          },
          "maxPrice": {
            "title": "Max price (store currency)",
            "minimum": 0,
            "type": "number",
            "description": "Only offers priced at or below this amount, for example 20. Set 0 to list only free offers."
          },
          "releasedAfter": {
            "title": "Released after (YYYY-MM-DD)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Only games released on or after this date, for example 2025-01-01."
          },
          "releasedBefore": {
            "title": "Released before (YYYY-MM-DD)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Only games released on or before this date, for example 2025-12-31."
          },
          "onlyActivePromotions": {
            "title": "Only games that are 100% free right now",
            "type": "boolean",
            "description": "Drop upcoming giveaways and discounted entries from the free games feed. Handy for alert bots.",
            "default": false
          },
          "productSlugs": {
            "title": "Game slugs or links",
            "type": "array",
            "description": "Slugs or store links, for example fortnite or https://store.epicgames.com/en-US/p/alan-wake-2. Each one returns a full record. Leave empty to skip.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Add system requirements and editions",
            "type": "boolean",
            "description": "Adds long description, system requirements, languages, age rating and editions to every row. Adds one request per row, so the run is slower.",
            "default": false
          },
          "includeRatings": {
            "title": "Add player rating",
            "type": "boolean",
            "description": "Adds Epic's average player rating (0 to 5) to each row that has one. A few extra requests, no extra charge.",
            "default": true
          },
          "maxItems": {
            "title": "Max rows to return",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum rows in total across free games, catalogue and games. Free plans are capped at 10 rows per run; paid plans up to 1,000,000. Leave empty for no limit."
          },
          "locale": {
            "title": "Text language and price format",
            "pattern": "^[A-Za-z]{2}(-[A-Za-z0-9]{2,4})?$",
            "type": "string",
            "description": "Language and number format for titles, descriptions and prices, for example en-US, es-ES, es-MX or de-DE. Applies to every country in the run.",
            "default": "en-US"
          },
          "onlyChanged": {
            "title": "Only new or changed offers",
            "type": "boolean",
            "description": "Return an offer only when it is new or its price or promotion changed since the last run. Unchanged offers are skipped and not charged.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name (optional)",
            "type": "string",
            "description": "Name of the memory of previous results, for example my-sales-watch. Empty derives it from your filters; use one name per saved search.",
            "default": ""
          },
          "resetSeen": {
            "title": "Forget previous results",
            "type": "boolean",
            "description": "Clear the memory of this monitor before the run, so every offer counts as new again.",
            "default": false
          },
          "country": {
            "title": "Country (legacy, do not use)",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "Single storefront country code, kept so older integrations keep working. Used only when the Countries list is empty.",
            "default": "US"
          },
          "includeFreeGames": {
            "title": "Free games feed enabled (legacy, do not use)",
            "type": "boolean",
            "description": "Legacy switch. Set it to false to turn the free games feed off in Auto or Free games modes; use the mode instead in new setups.",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}