{
  "openapi": "3.0.1",
  "info": {
    "title": "Steam Reviews Scraper – Steam API, Steam Player Count, Playtime",
    "description": "Steam reviews API, Steam store API and Steam review data to JSON/CSV: review text, playtime, thumbs up/down, helpfulness votes. Filter by playtime, keyword or review type; games mode adds price, genres, player count and tags. Game reviews API for game review sentiment data (text + thumbs, unscored).",
    "version": "0.1",
    "x-build-id": "JRDHWq1nkrNlQ7Qrm"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fetchsmith~steam-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fetchsmith-steam-reviews-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/fetchsmith~steam-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fetchsmith-steam-reviews-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/fetchsmith~steam-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fetchsmith-steam-reviews-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": {
          "dataType": {
            "title": "What to scrape",
            "enum": [
              "reviews",
              "games"
            ],
            "type": "string",
            "description": "reviews = player reviews for the given games; games = the store record for each game (price, genres, developer, review score summary, optional live player count).",
            "default": "reviews"
          },
          "apps": {
            "title": "Games",
            "type": "array",
            "description": "Steam store URLs or numeric App IDs, e.g. https://store.steampowered.com/app/1145360/Hades/ or 1145360. Leading/trailing spaces are ignored. A game NAME is not an App ID: it cannot be parsed, so it is skipped (named in the run's status message) — put names in \"Search terms\" instead.",
            "items": {
              "type": "string"
            }
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Find games by name instead of (or as well as) giving URLs. Each match is then scraped according to 'What to scrape'.",
            "items": {
              "type": "string"
            }
          },
          "maxReviewsPerApp": {
            "title": "Max reviews per game",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Reviews only: how many reviews to SCAN per game before moving to the next one (max 5000). This counts reviews looked at, before the keyword/minPlaytimeHours filter is applied — a low cap combined with a narrow filter can return far fewer matches than actually exist deeper in Steam's feed. Raise it if the log warns the cap was hit while filtering.",
            "default": 200
          },
          "maxResults": {
            "title": "Max results (total)",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Hard cap on rows pushed to the dataset across all games — also caps what you are charged.",
            "default": 2000
          },
          "language": {
            "title": "Review language",
            "type": "string",
            "description": "Steam language code for the reviews to return: english, schinese (Chinese), tchinese, russian, german, french, spanish, japanese, koreana (Korean), brazilian (Brazilian Portuguese), latam (Latin American Spanish), ... or \"all\" for every language. Use Steam's own code, not the plain language name — an unrecognized code (e.g. \"chinese\" or \"korean\") fails open to English reviews with no error.",
            "default": "english"
          },
          "reviewType": {
            "title": "Recommended / not recommended",
            "enum": [
              "all",
              "positive",
              "negative"
            ],
            "type": "string",
            "description": "positive = thumbs-up reviews only, negative = thumbs-down only.",
            "default": "all"
          },
          "purchaseType": {
            "title": "Purchase type",
            "enum": [
              "all",
              "steam",
              "non_steam_purchase"
            ],
            "type": "string",
            "description": "Currently a no-op (first 2026-10-23 source change — Steam's community review pages, which this Actor now reads, have no purchase-type filter; re-verified live 2026-11-12, still absent). Kept here in case that changes.",
            "default": "all"
          },
          "includeOffTopic": {
            "title": "Include off-topic review bombs",
            "type": "boolean",
            "description": "Currently a no-op (first 2026-10-23 source change — Steam's community review pages, which this Actor now reads, have no off-topic filter in either direction; re-verified live 2026-11-12, still absent). Kept here in case that changes.",
            "default": false
          },
          "sortBy": {
            "title": "Sort / selection",
            "enum": [
              "recent",
              "updated",
              "all",
              "funny"
            ],
            "type": "string",
            "description": "recent = newest first, updated = most recently edited first, all = Steam's helpfulness ranking (all-time by default, or pair with 'Last N days' below for one of Steam's own bucketed time windows), funny = Steam's \"Funny\" tab, the reviews with the most funny votes, always all-time. 'recent'/'updated'/'funny' have no date control at all; 'all' is the one exception (found live 2026-11-12, reachable only via the filter menu's onclick handlers, not a link — an earlier same-day check missed it). For an exact day count instead of a bucket, use 'Reviews after/before'.",
            "default": "recent"
          },
          "dayRange": {
            "title": "Last N days (Most helpful sort only — bucketed)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Only has an effect when Sort = Most helpful (sortBy: \"all\") — Steam exposes 6 fixed day-windows there (day/week/month/3 months/6 months/year), not an exact day count, so this rounds UP to the narrowest window that still covers your request (e.g. 5 -> week). Ignored for every other Sort. Use 'Reviews after/before' with Sort = Most recent for an exact day window instead. Mutually exclusive with 'Reviews after/before': a date window forces Sort to 'Most recent', which disables this field (the run says so). Keep the date window if you need an exact day range; drop it if you want the bucketed most-helpful window."
          },
          "reviewsAfter": {
            "title": "Reviews after (ISO date)",
            "type": "string",
            "description": "e.g. 2024-01-01. Keep only reviews created on or after this date. This is the ONLY working date filter (the old 'Last N days' is ignored), and it reaches any point in a game's history, not just the last year. Forces Sort to 'Most recent' so the date window can be applied correctly."
          },
          "reviewsBefore": {
            "title": "Reviews before (ISO date)",
            "type": "string",
            "description": "e.g. 2024-06-30. Keep only reviews created before this date. Combine with 'Reviews after' for an exact historical window (e.g. reviews from a specific patch or controversy). Forces Sort to 'Most recent'. Counts against maxReviewsPerApp: every review NEWER than this date is still scanned and discarded before paging reaches your window, so with a cutoff well in the past raise maxReviewsPerApp accordingly (reviewsAfter does NOT have this problem - it stops the scan cleanly). WATCH MODE WARNING: combined with watchLabel, a FIXED value here is a permanent dead end once the real date passes it — a newly-posted review's own createdAt is always \"now\", so no new review can ever be dated before an already-passed cutoff again. Leave it unset in a watched query; reviewsAfter alone is safe to keep. See README FAQ."
          },
          "minPlaytimeHours": {
            "title": "Minimum playtime (hours)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only reviews from players with at least this many hours in the game — a cheap way to drop drive-by reviews."
          },
          "keyword": {
            "title": "Keyword filter",
            "type": "string",
            "description": "Keep only reviews whose text contains this word or phrase (case-insensitive), e.g. \"crash\", \"controller\", \"price\". Leading/trailing spaces are ignored. Accented letters are Unicode-normalized before matching, so \"très\" matches regardless of which Unicode form (composed or decomposed) you typed it in."
          },
          "country": {
            "title": "Country / currency",
            "type": "string",
            "description": "Two-letter country code used for store prices and availability (us, gb, de, ...).",
            "default": "us"
          },
          "includeGameInfo": {
            "title": "Attach game info to every review",
            "type": "boolean",
            "description": "Adds gameName, developers, publishers, genres, releaseDate and storeUrl to each review row (one extra request per game).",
            "default": true
          },
          "includePlayerCount": {
            "title": "Include live player count",
            "type": "boolean",
            "description": "Game details only: also fetch the current concurrent player count for each game (one extra request per game).",
            "default": false
          },
          "includeOwnerEstimates": {
            "title": "Include owner estimates & tags",
            "type": "boolean",
            "description": "Game details only: adds estimated owner range (ownersMin/ownersMax), peak concurrent players yesterday and Steam's crowd-voted tags with vote counts, from the free public SteamSpy API (one extra request per game, paced to 1/second). Steam's own store API exposes none of these.",
            "default": false
          },
          "searchLimit": {
            "title": "Games per search term",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many games to take from each search term. Steam's own store search returns at most 10 matches per term and offers no paging, so any value above 10 has no effect — the run warns and reports it in RUN_SUMMARY.ignoredInputs when you set one. To cover more games, list them in \"apps\" as store URLs or App IDs.",
            "default": 10
          },
          "watchLabel": {
            "title": "Watch label (alert mode)",
            "type": "string",
            "description": "Set a name (e.g. \"my-game-reviews\") to turn this run into a watch: the FIRST run for a given label + filter set records which reviews already exist and returns nothing (0 charged). Every run after that returns only reviews posted since the last run under the same label, so you can schedule this Actor and get alerted on new reviews without re-paying for ones you already have. Changing any filter (apps/searchTerms/searchLimit/country/language/reviewType/purchaseType/includeOffTopic/sortBy/dayRange/keyword/minPlaytimeHours/reviewsAfter/reviewsBefore) starts a fresh baseline. Reviews only — ignored when dataType is \"games\". Leave empty for normal one-off runs."
          },
          "watchEvents": {
            "title": "Watch events to report",
            "type": "array",
            "description": "Optional. Only report these kinds of change in watch mode — e.g. pick \"Thumbs-up/thumbs-down edited\" alone to be alerted only when an existing reviewer flips their recommendation, and never pay for anything else. Leave empty for both. Steam keeps a review's id stable when its author edits it in place, including flipping their own thumbs-up/thumbs-down — without this event an already-delivered review that later flips is invisible to a watch forever. Steam reviews have no developer-response feature, so that is not a watchable event here. The change event compares against the recommendation recorded the last time the review was delivered, so it only starts firing on the second run after a baseline created before this feature existed. Ignored when \"Watch label\" is empty.",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "recommendationChanged"
              ],
              "enumTitles": [
                "New review",
                "Thumbs-up/thumbs-down edited (reviewer changed their own recommendation)"
              ]
            },
            "default": []
          },
          "webhookUrl": {
            "title": "Webhook URL (notify on completion)",
            "type": "string",
            "description": "Optional. An http(s) URL to POST a small JSON summary to when the run finishes — results pushed, watch-label new count if Watch label is set, and the run's dataset ID so you can fetch the results. A convenience for callers who want a completion ping without setting up an Apify platform webhook (which needs separate Console/API configuration per Task, not per run). Best-effort: a failed or slow webhook is logged as a warning and never fails the run or affects charging — it fires after every result has already been pushed and charged. Leave empty to skip."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}