{
  "openapi": "3.0.1",
  "info": {
    "title": "Steam Reviews Scraper for Steam Game Reviews and Store Data",
    "description": "Steam reviews scraper: export Steam game reviews with playtime, votes, language, refunds, Steam Deck, hardware and developer replies. Filter by date, language or playtime. Game names or store links in; review score and store data per game. No login or API key. Maintained by CleanScrape.",
    "version": "0.1",
    "x-build-id": "jGOeKS7FcPCidgUGc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cleanscrape~steam-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cleanscrape-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/cleanscrape~steam-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-cleanscrape-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/cleanscrape~steam-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-cleanscrape-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",
        "required": [
          "games"
        ],
        "properties": {
          "games": {
            "title": "Games",
            "type": "array",
            "description": "One per line: the game's name (\"Stardew Valley\"), its Steam store link (store.steampowered.com/app/413150/...) or its app ID (413150). A name is matched to the game Steam lists for it; the run report says which one.",
            "items": {
              "type": "string"
            }
          },
          "maxReviewsPerGame": {
            "title": "Reviews per game",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "The most reviews to save for each game. Steam gives 100 per request, so even a game with 500,000 reviews can be read in full; that takes a few minutes.",
            "default": 200
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "recent",
              "helpful",
              "updated",
              "funny"
            ],
            "type": "string",
            "description": "Which reviews come first, so a limit keeps the ones you want.",
            "default": "recent"
          },
          "reviewType": {
            "title": "Reviews to include",
            "enum": [
              "all",
              "positive",
              "negative"
            ],
            "type": "string",
            "description": "Negative reviews only is the quickest way to see what players complain about.",
            "default": "all"
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Reviews written in these languages. Leave empty for every language.",
            "items": {
              "type": "string",
              "enum": [
                "english",
                "schinese",
                "tchinese",
                "russian",
                "spanish",
                "latam",
                "brazilian",
                "portuguese",
                "german",
                "french",
                "turkish",
                "polish",
                "koreana",
                "japanese",
                "italian",
                "ukrainian",
                "thai",
                "czech",
                "dutch",
                "swedish",
                "danish",
                "finnish",
                "norwegian",
                "hungarian",
                "greek",
                "romanian",
                "bulgarian",
                "vietnamese",
                "indonesian",
                "arabic"
              ],
              "enumTitles": [
                "English",
                "Chinese (Simplified)",
                "Chinese (Traditional)",
                "Russian",
                "Spanish (Spain)",
                "Spanish (Latin America)",
                "Portuguese (Brazil)",
                "Portuguese (Portugal)",
                "German",
                "French",
                "Turkish",
                "Polish",
                "Korean",
                "Japanese",
                "Italian",
                "Ukrainian",
                "Thai",
                "Czech",
                "Dutch",
                "Swedish",
                "Danish",
                "Finnish",
                "Norwegian",
                "Hungarian",
                "Greek",
                "Romanian",
                "Bulgarian",
                "Vietnamese",
                "Indonesian",
                "Arabic"
              ]
            },
            "default": []
          },
          "dateFrom": {
            "title": "Written from",
            "type": "string",
            "description": "Only reviews written on or after this day (UTC): 2026-01-01, or relative: \"-30 days\", \"-6 months\", yesterday."
          },
          "dateTo": {
            "title": "Written until",
            "type": "string",
            "description": "Only reviews written on or before this day (UTC). Leave empty for up to today."
          },
          "minPlaytimeHours": {
            "title": "Minimum playtime at review (hours)",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Only reviews whose author had played at least this long when writing it. Useful to skip first-impression reviews."
          },
          "maxPlaytimeHours": {
            "title": "Maximum playtime at review (hours)",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Only reviews written within this many hours of play, for example 2 to study first impressions and refunds."
          },
          "purchaseType": {
            "title": "Purchase type",
            "enum": [
              "all",
              "steam",
              "not_steam"
            ],
            "type": "string",
            "description": "Steam's own review score counts only players who bought the game on Steam.",
            "default": "all"
          },
          "steamDeckOnly": {
            "title": "Only Steam Deck players",
            "type": "boolean",
            "description": "Only reviews by players who played mostly on Steam Deck when they wrote the review.",
            "default": false
          },
          "includeReviewBombs": {
            "title": "Include off-topic review bombs",
            "type": "boolean",
            "description": "Steam hides reviews it marks as off-topic activity (\"review bombs\") by default. Turn on to include them.",
            "default": false
          },
          "includeGameDetails": {
            "title": "Store details for each game",
            "type": "boolean",
            "description": "Adds price, discount, release date, developers, publishers, genres, tags of features, platforms and Metacritic score to each game's row (table \"Games\"). Each game row also has its review score and totals either way.",
            "default": true
          },
          "onlyNewReviews": {
            "title": "Only new reviews (for scheduled runs)",
            "type": "boolean",
            "description": "Each run saves only reviews written since the newest review an earlier run saved, so a daily schedule gives you just the new ones. The first run saves the latest reviews up to \"Reviews per game\".",
            "default": false
          },
          "watchName": {
            "title": "Watch name",
            "type": "string",
            "description": "Optional, with \"Only new reviews\". Runs with the same games and filters share one history; give a name (such as \"My game daily\") to keep separate histories."
          },
          "country": {
            "title": "Store country",
            "type": "string",
            "description": "Two-letter country for game-name search, prices and currency in the game rows: us, gb, de, fr, jp. Reviews are the same in every country.",
            "default": "us"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}