# Steam Scraper (`sallbro/steam-scraper`) Actor

Scrape Steam game listings, details, pricing, reviews, news, media, developer info, and similar games. Supports pagination, search, and flexible per-game data collection.

- **URL**: https://apify.com/sallbro/steam-scraper.md
- **Developed by:** [Salman Asu](https://apify.com/sallbro) (community)
- **Categories:** Automation, Other, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.00005 / actor start

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Steam Game Scraper — Apify Actor

Scrape Steam game data without any API key. Six focused modes cover everything from lightweight catalog browsing to deep per-game extraction of pricing, reviews, news, media, developer info, and similar games.

---

### Table of contents

- [Modes](#modes)
- [Input parameters](#input-parameters)
- [Example inputs](#example-inputs)
- [Output schema](#output-schema)
- [Project structure](#project-structure)
- [Run locally](#run-locally)
- [Publish to Apify](#publish-to-apify)
- [Rate limiting and proxy](#rate-limiting-and-proxy)

---

### Modes

The `mode` field controls everything. Each mode pre-configures which sections are enabled — no need to toggle individual flags.

| Mode | Paginates catalog | Deep-scrapes games | Sections enabled |
|---|---|---|---|
| `list-lite` | yes | no | id, name, price, discount, image, release date |
| `list-full` | yes | yes | all sections |
| `specific` | no | yes | all sections |
| `review` | no | yes | reviews only |
| `news` | no | yes | news only |
| `media` | no | yes | screenshots, videos, artwork, broadcasts |
| `search` | no | no | keyword search results |

**list-lite** — fastest and cheapest. Paginates Steam's popular new catalog and saves one lightweight record per game. Good for price monitoring or collecting IDs to pass into other modes.

**list-full** — paginates the catalog then deep-scrapes every game found. Heavy on compute units. Use `maxPages` to control scope.

**specific** — deep-scrapes a list of `gameIds` you provide with all sections enabled. The most common production mode.

**review** — scrapes only reviews for the given `gameIds`. Fast and cheap per game. Supports sentiment filtering (positive / negative / all) and seven sort categories.

**news** — scrapes only news and announcements for the given `gameIds`. Works well as a scheduled daily run.

**media** — scrapes only screenshots, videos, artwork, and broadcasts for the given `gameIds`. Useful for content pipelines.

**search** — searches Steam by keyword using the suggest API and returns matching games with id, name, price, and image.

> Advanced: you can override any individual section flag on top of a mode preset. For example, `mode: "review"` with `"includeMedia": true` added will scrape both reviews and media.

---

### Input parameters

```json
{
    "mode": "list-lite",
    "gameIds": [],
    "searchQuery": "",
    "startPage": 1,
    "maxPages": 5,
    "currency": "US",
    "language": "english",
    "reviewCategory": "toprated",
    "reviewType": "all",
    "newsCategory": "all",
    "reviewsLimit": 10,
    "newsLimit": 10,
    "mediaLimit": 10,
    "proxyConfiguration": { "useApifyProxy": true }
}
````

| Parameter | Type | Default | Used in modes | Description |
|---|---|---|---|---|
| `mode` | string | `list-lite` | all | Scraping mode. See table above. |
| `gameIds` | array | `[]` | specific, review, news, media | Steam App IDs. Example: `[570, 730, 1091500]` |
| `searchQuery` | string | `""` | search | Keyword to search for |
| `startPage` | integer | `1` | list-lite, list-full | Catalog page to start from (1-based) |
| `maxPages` | integer | `5` | list-lite, list-full | Number of catalog pages to scrape. Each page returns ~50 games |
| `currency` | string | `US` | all | `US` for USD ($) or `IN` for INR (₹) |
| `language` | string | `english` | specific, list-full, review, news | Language for reviews and news |
| `reviewCategory` | string | `toprated` | review, specific, list-full | How to sort reviews |
| `reviewType` | string | `all` | review, specific, list-full | Sentiment filter for reviews |
| `newsCategory` | string | `all` | news, specific, list-full | Type of news to fetch |
| `reviewsLimit` | integer | `10` | review, specific, list-full | Max reviews per game (1–100) |
| `newsLimit` | integer | `10` | news, specific, list-full | Max news items per game (1–100) |
| `mediaLimit` | integer | `10` | media, specific, list-full | Max items per media type per game (1–50) |
| `proxyConfiguration` | object | `{}` | all | Apify proxy config. Recommended for runs over 500 games |

#### `language` values

`english` `spanish` `french` `german` `portuguese` `russian` `japanese` `koreana` `schinese` `tchinese`

#### `reviewCategory` values

`toprated` `mostrecent` `trendday` `trendweek` `trendmonth` `trendyear` `funny`

#### `reviewType` values

`all` `positive` `negative`

#### `newsCategory` values

`all` `announcements` `syndicated`

***

### Example inputs

#### Scrape catalog, basic info only (list-lite)

```json
{
    "mode": "list-lite",
    "startPage": 1,
    "maxPages": 10,
    "currency": "US"
}
```

#### Full deep-scrape of 3 specific games (specific)

```json
{
    "mode": "specific",
    "gameIds": [570, 730, 1091500],
    "currency": "US",
    "language": "english",
    "reviewCategory": "toprated",
    "reviewType": "all",
    "newsCategory": "announcements",
    "reviewsLimit": 20,
    "newsLimit": 10,
    "mediaLimit": 15
}
```

#### Negative reviews only, in German (review)

```json
{
    "mode": "review",
    "gameIds": [730, 570],
    "language": "german",
    "reviewType": "negative",
    "reviewCategory": "mostrecent",
    "reviewsLimit": 50
}
```

#### Daily news run (news)

```json
{
    "mode": "news",
    "gameIds": [570, 730, 1172470, 1091500],
    "newsCategory": "announcements",
    "newsLimit": 5,
    "language": "english"
}
```

#### Pull media assets for a game (media)

```json
{
    "mode": "media",
    "gameIds": [1091500],
    "mediaLimit": 30
}
```

#### Keyword search (search)

```json
{
    "mode": "search",
    "searchQuery": "open world rpg",
    "currency": "US"
}
```

#### Full catalog + deep scrape (list-full, small run)

```json
{
    "mode": "list-full",
    "startPage": 1,
    "maxPages": 2,
    "currency": "US",
    "reviewsLimit": 5,
    "newsLimit": 5,
    "mediaLimit": 5,
    "proxyConfiguration": { "useApifyProxy": true }
}
```

***

### Output schema

Every dataset record contains `_type` and `_mode` fields that identify which mode produced it. Records from deep-scrape modes also always include the core game fields (name, description, pricing, etc.) plus whichever section fields the mode enables.

***

#### list-lite record

Produced by `list-lite` mode. One record per game per page.

```json
{
    "_type": "list-lite",
    "_mode": "list-lite",
    "page": 1,
    "id": "1091500",
    "name": "Cyberpunk 2077",
    "releaseDate": "10 Dec, 2020",
    "image": "https://cdn.cloudflare.steamstatic.com/steam/apps/1091500/capsule_sm_120.jpg",
    "price": "$29.99",
    "originalPrice": "$59.99",
    "discount": "-50%",
    "steamUrl": "https://store.steampowered.com/app/1091500/"
}
```

> `originalPrice` and `discount` are only present when the game is on sale.

***

#### Core game fields

All deep-scrape modes (`specific`, `list-full`, `review`, `news`, `media`) always fetch the core game page and produce these fields. Section-specific fields appear alongside these.

```json
{
    "_type": "specific",
    "_mode": "specific",
    "gameId": "570",
    "scrapedAt": "2025-05-13T08:00:00.000Z",
    "name": "Dota 2",
    "steamUrl": "https://store.steampowered.com/app/570/",
    "description": "Every day, millions of players worldwide enter battle as one of over a hundred Dota heroes.",
    "releaseDate": "9 Jul, 2013",
    "headerImage": "https://cdn.akamai.steamstatic.com/steam/apps/570/header.jpg",
    "reviewSummary": "Overwhelmingly Positive",
    "genres": ["Free to Play", "Strategy"],
    "tags": ["Free to Play", "MOBA", "Strategy", "Multiplayer", "Team-Based", "Competitive"],
    "languages": ["English", "French", "German", "Spanish", "Portuguese", "Russian", "Japanese"],
    "developer": ["Valve"],
    "publisher": ["Valve"],
    "franchise": [],
    "pricing": [
        {
            "packageTitle": "Dota 2",
            "discount": "0%",
            "originalPrice": "Free",
            "discountPrice": "Free"
        }
    ],
    "externalLinks": [
        { "name": "website",  "link": "https://www.dota2.com" },
        { "name": "X",        "link": "https://x.com/DOTA2" },
        { "name": "YouTube",  "link": "https://youtube.com/@dota2" }
    ],
    "systemRequirements": {
        "win": {
            "minimum": {
                "OS": "Windows 7",
                "Processor": "Dual core from Intel or AMD at 2.8 GHz",
                "Memory": "4 GB RAM",
                "Graphics": "nVidia GeForce 8600/9600GT",
                "Storage": "15 GB available space"
            },
            "recommended": {
                "OS": "Windows 10",
                "Processor": "Intel Core i5 at 3.0 GHz",
                "Memory": "8 GB RAM",
                "Graphics": "nVidia GeForce GTX 970",
                "Storage": "15 GB available space"
            }
        },
        "linux": {
            "minimum": { "Storage": "15 GB available space" },
            "recommended": {}
        }
    },
    "aboutGame": "Dota is a competitive game of action and strategy, played both professionally and casually..."
}
```

> `systemRequirements` contains keys `win`, `linux`, and/or `mac` depending on what Steam lists. Each has `minimum` and `recommended` objects whose keys are the requirement label (OS, Processor, Memory, etc.).

***

#### devInfo section

Present on `specific` and `list-full` records.

```json
"devInfo": {
    "developer": ["Valve"],
    "publisher": ["Valve"],
    "franchise": []
}
```

***

#### media section

Present on `media`, `specific`, and `list-full` records.

```json
"media": {
    "screenshots": [
        {
            "url": "https://steamcommunity.com/sharedfiles/.../116x65.jpg",
            "fullUrl": "https://steamcommunity.com/sharedfiles/.../1920x1080.jpg"
        }
    ],
    "videos": [
        {
            "youtubeId": "dqRTiAMiCKg",
            "youtubeUrl": "https://www.youtube.com/watch?v=dqRTiAMiCKg",
            "thumbnail": "https://i.ytimg.com/vi/dqRTiAMiCKg/hqdefault.jpg"
        }
    ],
    "artwork": [
        {
            "url": "https://steamcommunity.com/sharedfiles/.../artwork.jpg"
        }
    ],
    "broadcasts": [
        {
            "broadcastUrl": "https://steamcommunity.com/broadcast/watch/...",
            "thumbnail": "https://steamcommunity.com/broadcast/..."
        }
    ]
}
```

> Each array is capped at `mediaLimit`. `fullUrl` on screenshots is the original high-res version derived by replacing the thumbnail dimensions in the URL.

***

#### reviews section

Present on `review`, `specific`, and `list-full` records.

```json
"reviews": {
    "reviews": [
        {
            "reviewId": "someusername_570",
            "title": "Recommended",
            "content": "Best MOBA out there. The learning curve is steep but absolutely worth it.",
            "date": "Posted: 10 January",
            "userName": "SteamPlayer123",
            "userProfile": "https://avatars.steamstatic.com/abc123_full.jpg"
        }
    ],
    "category": "toprated",
    "type": "all",
    "language": "english",
    "limit": 10,
    "offset": 0,
    "total": 10
}
```

> `reviewId` is `{username}_{gameId}` derived from the review URL. `userProfile` is always the full-size avatar (suffix `_full.jpg`).

***

#### news section

Present on `news`, `specific`, and `list-full` records.

```json
"news": {
    "news": [
        {
            "title": "Dota 2 Update — The Crownfall Act IV",
            "date": "8 Jan",
            "content": "Crownfall Act IV is now live. New hero Ringmaster has been added to the roster...",
            "likes": "2.4k",
            "category": "announcements"
        }
    ],
    "category": "announcements",
    "language": "english",
    "limit": 10,
    "offset": 0,
    "total": 10
}
```

***

#### similarGames section

Present on `specific` and `list-full` records.

```json
"similarGames": {
    "similarGames": [
        {
            "id": "1046930",
            "name": "Dota Underlords",
            "price": "Free to Play",
            "image": "https://cdn.cloudflare.steamstatic.com/steam/apps/1046930/capsule_sm_120.jpg",
            "steamUrl": "https://store.steampowered.com/app/1046930/"
        }
    ],
    "total": 8
}
```

***

#### search record

Produced by `search` mode. One record per result.

```json
{
    "_type": "search",
    "_mode": "search",
    "query": "open world rpg",
    "id": "1091500",
    "name": "Cyberpunk 2077",
    "image": "https://cdn.cloudflare.steamstatic.com/steam/apps/1091500/capsule_sm_120.jpg",
    "price": "$29.99",
    "steamUrl": "https://store.steampowered.com/app/1091500/"
}
```

***

#### Error fields

When a section fails for a game, the actor logs the error and saves an error field instead of skipping the record entirely. The run continues.

| Field | When present |
|---|---|
| `detailsError` | Core game page failed to load |
| `devInfoError` | Developer info section failed |
| `mediaError` | Media section failed |
| `reviewsError` | Reviews section failed |
| `newsError` | News section failed |
| `similarGamesError` | Similar games section failed |

***

### Project structure

```
steam-game-scraper/
│
├── .actor/
│   ├── actor.json          ## Actor name, version, dataset table view
│   └── INPUT_SCHEMA.json   ## Input form rendered in Apify console
│
├── src/
│   ├── main.js             ## Entry point — mode presets, orchestration
│   │
│   ├── scrapers/
│   │   ├── gameList.js     ## Catalog pagination (50/page, JSON response)
│   │   ├── gameDetails.js  ## Full store page — all core fields
│   │   ├── gameMedia.js    ## Screenshots, videos, artwork, broadcasts
│   │   ├── gameReviews.js  ## Reviews with sentiment + sort filtering
│   │   ├── gameNews.js     ## News and announcements
│   │   ├── devInfo.js      ## Developer, publisher, franchise
│   │   ├── similarGames.js ## More Like This recommendations
│   │   └── search.js       ## Keyword search via Steam suggest API
│   │
│   └── utils/
│       ├── http.js         ## All Steam URLs + Axios client (cookies, retry, backoff)
│       └── logger.js       ## Console logger
│
├── apify_storage/          ## Local dev storage — gitignored
│   └── key_value_stores/default/INPUT.json
│
├── Dockerfile
├── package.json
├── .gitignore
└── README.md
```

#### URL source of truth

All Steam endpoint URLs are defined in `src/utils/http.js` under the `URLS` object, mapped exactly from the project `.env`. The `appHubSubSection` values used for the `/homecontent/` endpoint are:

| Section | `appHubSubSection` |
|---|---|
| Screenshots | 2 |
| Videos | 3 |
| Artwork | 4 |
| Workshop | 6 |
| Official announcements | 8 |
| Guides | 9 |
| All reviews | 10 |
| Broadcasts | 13 |
| All news | 14 |
| Positive reviews | 16 |
| Negative reviews | 17 |

***

### Run locally

```bash
## Install dependencies
npm install

## Install Apify CLI (once)
npm install -g apify-cli

## Login
apify login

## Edit test input
nano apify_storage/key_value_stores/default/INPUT.json

## Run
npm run start:dev
```

Output saves to `apify_storage/datasets/default/`.

***

### Publish to Apify

```bash
apify push
```

Then in [Apify Console](https://console.apify.com) → your actor → **Publication** tab:

1. Set title, description, and categories (Web Scraping, Gaming)
2. Upload a cover image
3. Set pricing tiers
4. Click **Publish to Store**

***

### Rate limiting and proxy

Built-in protections:

- 1200ms delay between games in all deep-scrape modes
- 400ms delay between pagination requests within each scraper
- 3× retry with exponential backoff (1.5s → 3s → 4.5s) on failed requests
- Steam age-gate bypass via `birthtime` cookie on every request
- 404 responses are not retried — the game is skipped and the run continues

For runs over 500 games, enable proxy:

```json
{
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}
```

# Actor input Schema

## `mode` (type: `string`):

list-lite: fast catalog scrape, basic info only. list-full: catalog + full deep-scrape of every game. specific: deep-scrape given gameIds, all sections. review: reviews only for given gameIds. news: news/announcements only. media: screenshots, videos, artwork, broadcasts only. search: keyword search.

## `gameIds` (type: `array`):

Steam App IDs to scrape. Required for modes: specific, review, news, media. Example: \[570, 730, 1091500]

## `searchQuery` (type: `string`):

Keyword to search Steam for. Only used in 'search' mode.

## `startPage` (type: `integer`):

Catalog page to start from. Used in list-lite and list-full modes. Each page returns 50 games.

## `maxPages` (type: `integer`):

Max catalog pages to paginate. Used in list-lite and list-full. 1 page = ~50 games.

## `currency` (type: `string`):

Pricing currency for all scraped prices.

## `language` (type: `string`):

Language for reviews and news. Applies to review, news, list-full, specific modes.

## `reviewCategory` (type: `string`):

How to sort reviews. Used in review, specific, list-full modes.

## `reviewType` (type: `string`):

Filter reviews by sentiment. Used in review, specific, list-full modes.

## `newsCategory` (type: `string`):

Type of news to fetch. Used in news, specific, list-full modes.

## `reviewsLimit` (type: `integer`):

Max reviews per game.

## `newsLimit` (type: `integer`):

Max news items per game.

## `mediaLimit` (type: `integer`):

Max items per media type (screenshots, videos, artwork, broadcasts) per game.

## `proxyConfiguration` (type: `object`):

Apify proxy settings. Recommended for list-full runs over 500 games.

## Actor input object example

```json
{
  "mode": "list-lite",
  "gameIds": [],
  "searchQuery": "",
  "startPage": 1,
  "maxPages": 5,
  "currency": "US",
  "language": "english",
  "reviewCategory": "toprated",
  "reviewType": "all",
  "newsCategory": "all",
  "reviewsLimit": 10,
  "newsLimit": 10,
  "mediaLimit": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("sallbro/steam-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("sallbro/steam-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call sallbro/steam-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sallbro/steam-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Steam Scraper",
        "description": "Scrape Steam game listings, details, pricing, reviews, news, media, developer info, and similar games. Supports pagination, search, and flexible per-game data collection.",
        "version": "1.0",
        "x-build-id": "EvnZb5V0tcvtfIpMy"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sallbro~steam-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sallbro-steam-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/sallbro~steam-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sallbro-steam-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/sallbro~steam-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sallbro-steam-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": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "list-lite",
                            "list-full",
                            "specific",
                            "review",
                            "news",
                            "media",
                            "search"
                        ],
                        "type": "string",
                        "description": "list-lite: fast catalog scrape, basic info only. list-full: catalog + full deep-scrape of every game. specific: deep-scrape given gameIds, all sections. review: reviews only for given gameIds. news: news/announcements only. media: screenshots, videos, artwork, broadcasts only. search: keyword search.",
                        "default": "list-lite"
                    },
                    "gameIds": {
                        "title": "Game IDs",
                        "type": "array",
                        "description": "Steam App IDs to scrape. Required for modes: specific, review, news, media. Example: [570, 730, 1091500]",
                        "default": []
                    },
                    "searchQuery": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Keyword to search Steam for. Only used in 'search' mode.",
                        "default": ""
                    },
                    "startPage": {
                        "title": "Start Page",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Catalog page to start from. Used in list-lite and list-full modes. Each page returns 50 games.",
                        "default": 1
                    },
                    "maxPages": {
                        "title": "Max Pages",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Max catalog pages to paginate. Used in list-lite and list-full. 1 page = ~50 games.",
                        "default": 5
                    },
                    "currency": {
                        "title": "Currency",
                        "enum": [
                            "US",
                            "IN"
                        ],
                        "type": "string",
                        "description": "Pricing currency for all scraped prices.",
                        "default": "US"
                    },
                    "language": {
                        "title": "Language",
                        "enum": [
                            "english",
                            "spanish",
                            "french",
                            "german",
                            "portuguese",
                            "russian",
                            "japanese",
                            "koreana",
                            "schinese",
                            "tchinese"
                        ],
                        "type": "string",
                        "description": "Language for reviews and news. Applies to review, news, list-full, specific modes.",
                        "default": "english"
                    },
                    "reviewCategory": {
                        "title": "Review Sort",
                        "enum": [
                            "toprated",
                            "mostrecent",
                            "trendday",
                            "trendweek",
                            "trendmonth",
                            "trendyear",
                            "funny"
                        ],
                        "type": "string",
                        "description": "How to sort reviews. Used in review, specific, list-full modes.",
                        "default": "toprated"
                    },
                    "reviewType": {
                        "title": "Review Sentiment",
                        "enum": [
                            "all",
                            "positive",
                            "negative"
                        ],
                        "type": "string",
                        "description": "Filter reviews by sentiment. Used in review, specific, list-full modes.",
                        "default": "all"
                    },
                    "newsCategory": {
                        "title": "News Category",
                        "enum": [
                            "all",
                            "announcements",
                            "syndicated"
                        ],
                        "type": "string",
                        "description": "Type of news to fetch. Used in news, specific, list-full modes.",
                        "default": "all"
                    },
                    "reviewsLimit": {
                        "title": "Reviews Limit",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Max reviews per game.",
                        "default": 10
                    },
                    "newsLimit": {
                        "title": "News Limit",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Max news items per game.",
                        "default": 10
                    },
                    "mediaLimit": {
                        "title": "Media Limit (per type)",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "Max items per media type (screenshots, videos, artwork, broadcasts) per game.",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Apify proxy settings. Recommended for list-full runs over 500 games.",
                        "default": {
                            "useApifyProxy": 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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
