# itch.io Game Scraper (`unfenced-group/itchio-scraper`) Actor Scrape indie games from itch.io — prices, sales, ratings, tags, genres, platforms, languages, screenshots and trailers. Browse by sort, tag or genre, or pass game URLs. 30+ fields, from $0.69/1k. - **URL**: https://apify.com/unfenced-group/itchio-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.79 / 1,000 game results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## itch.io Game Scraper ![Banner](https://api.apify.com/v2/key-value-stores/lJlifu6C8YQfZMPKE/records/itchio-scraper) Extract structured game data from **itch.io**, the open marketplace for indie games, tools, and assets. Browse by sort order, tag, or genre — or hand the actor a list of specific game URLs — and get clean, normalized data for market research, price tracking, catalogue building, or trend analysis. No login, no API key, no setup. Just pick what to scrape and run. ### What you get - **Browse any list** — New & Popular, Newest, Top Rated, Most Popular, On Sale, Free, or Top Sellers. - **Tag and genre browsing** — pull every game under a tag (`horror`, `pixel-art`, `roguelike`, `visual-novel`) or genre (`action`, `puzzle`, `rpg`, `platformer`). - **Direct URL scraping** — pass a list of game page URLs to scrape exactly those. - **Full pricing** — current price, original price, sale percentage, currency, free / pay-what-you-want detection. - **Rich metadata** — rating and rating count, genre, tags, languages, supported platforms, input methods, accessibility features, multiplayer, average session length, AI disclosure, and more. - **Media** — cover image, full screenshot gallery, and trailer URL. - **Built-in filters** — price state, platform, rating, and price range, applied for you so you only keep what you want. ### Output fields **Always present (browse / list mode):** | Field | Description | |---|---| | `gameId` | itch.io numeric game ID | | `title` | Game title | | `url` | Game page URL | | `shortText` | Short tagline / summary | | `author` | Creator / studio name | | `authorUrl` | Creator profile URL | | `coverImage` | Cover / thumbnail image URL | | `platforms` | Array of platforms (Windows, macOS, Linux, Android, Web) | | `priceDisplay` | Current price as shown (or "Free") | | `originalPriceDisplay` | Original price when on sale | | `currency` | Currency code | | `salePercent` | Discount percentage when on sale | | `isOnSale` | Whether the game is currently discounted | | `isFree` | Whether the game is free | | `payWhatYouWant` | Whether the buyer can name their own price | | `priceValue` | Numeric current price | | `originalPriceValue` | Numeric original price | | `scrapedAt` | ISO timestamp of the scrape | **Added with Fetch detail pages enabled:** | Field | Description | |---|---| | `statusFlag` | Released, In development, Prototype, etc. | | `publishedDisplay` | Published date | | `updatedDisplay` | Last updated date | | `releaseDateDisplay` | Release date when listed | | `genre` | Primary genre | | `tags` | Array of tags | | `madeWith` | Tools / engines used | | `languages` | Supported languages | | `inputs` | Supported input methods | | `accessibility` | Accessibility features | | `averageSession` | Typical play session length | | `multiplayer` | Multiplayer modes | | `playerCount` | Player count | | `assetLicense` | Asset license (for asset listings) | | `aiDisclosure` | Generative-AI disclosure statement | | `externalLinks` | External links (Steam, official site, etc.) | | `ratingValue` | Average rating (0–5) | | `ratingCount` | Number of ratings | | `descriptionHtml` | Full description (HTML) | | `descriptionText` | Full description (plain text) | | `screenshots` | Array of screenshot URLs | | `trailerUrl` | Trailer URL when present | #### Example output ```json { "gameId": "4696246", "title": "MATILDA 2", "url": "https://redcap-games.itch.io/matilda-2", "shortText": "THE NIGHTMARE WAS NEVER OVER!", "author": "Red Cap Games", "authorUrl": "https://redcap-games.itch.io", "coverImage": "https://img.itch.zone/.../original/Pg8.png", "platforms": ["Windows"], "priceDisplay": "$2.50 USD", "originalPriceDisplay": "$5.00", "currency": "USD", "salePercent": 50, "isOnSale": true, "isFree": false, "payWhatYouWant": true, "statusFlag": "Released", "genre": "Action", "tags": ["3D", "Atmospheric", "Horror", "Psychological Horror", "Singleplayer"], "ratingValue": 4.2, "ratingCount": 6, "aiDisclosure": "AI Assisted, Graphics", "trailerUrl": "https://www.youtube.com/watch?v=PzcOz566GeQ", "screenshots": ["https://img.itch.zone/...", "https://img.itch.zone/..."], "scrapedAt": "2026-06-24T07:00:00.000Z" } ```` ### Examples **Newest free games:** ```json { "sort": "free", "maxResults": 50 } ``` **Top-rated horror games with full detail:** ```json { "tag": "horror", "sort": "top-rated", "maxResults": 100, "fetchDetails": true } ``` **On-sale puzzle games only, with rating filter:** ```json { "genre": "puzzle", "fetchDetails": true, "priceFilter": "onSale", "minRating": 4 } ``` **Scrape specific games by URL:** ```json { "startUrls": [ { "url": "https://redcap-games.itch.io/matilda-2" }, { "url": "https://shawcat.itch.io/last-kid-on-the-bus" } ] } ``` ### 💰 Pricing **$0.99 per 1,000 results** — you only pay for successfully retrieved games. Failed retries and filtered-out games are never charged. | Results | Cost | |---------|------| | 100 | ~$0.10 | | 1,000 | ~$0.99 | | 10,000 | ~$9.90 | | 100,000 | ~$99.00 | Volume discounts apply automatically down to **$0.69 per 1,000** at the highest tier. No subscription, no per-run start fee. > Flat-rate alternatives typically charge $29–$49/month regardless of usage. Use the **Max results** cap in the input to control your spend exactly. ### Notes - itch.io shows each game's price in the single currency its creator chose; the scraper reports that currency as listed. - Detail fields (genre, tags, rating, screenshots, etc.) require **Fetch detail pages**. Browse mode alone returns the lighter list-level field set quickly and cheaply. - The actor respects itch.io's robots.txt and scrapes only its public browse and game pages. *** ### Run it on a schedule This actor is built for repeat use. Set it to run daily, weekly, or hourly, and the data keeps flowing without you touching it. - **Schedule runs** — open the actor, go to Schedules, and pick a cadence. Each run only charges you for the results it returns. - **Connect it to your stack** — push results straight to Google Sheets, Slack, a webhook, or your database using Apify Integrations. No glue code needed. - **Pull results via API** — every run writes a clean dataset you can fetch with one API call, ready for whatever you build on top of it. Set it once and it runs on its own. *** ### Need a custom scraper? **[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free. If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio. **Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl) # Actor input Schema ## `sort` (type: `string`): Which itch.io browse list to scrape. Ignored when a Tag, Genre, or Start URLs are provided. ## `tag` (type: `string`): Browse a specific itch.io tag (e.g. "horror", "pixel-art", "roguelike", "visual-novel"). Overrides Browse mode. ## `genre` (type: `string`): Browse a specific itch.io genre (e.g. "action", "puzzle", "rpg", "platformer", "shooter"). Overrides Browse mode (used only if Tag is empty). ## `classification` (type: `string`): Restrict to a project type. ## `maxResults` (type: `integer`): Maximum number of games to return. ## `fetchDetails` (type: `boolean`): Visit each game's page for the full field set (genre, tags, languages, rating, screenshots, trailer, description, AI disclosure, accessibility, and more). Slower but far richer. Required for the filters below to work on detail-only fields. ## `startUrls` (type: `array`): Optional list of specific itch.io game page URLs to scrape directly (e.g. https://author.itch.io/my-game). When provided, Browse mode / Tag / Genre are ignored. Detail pages are always fetched for Start URLs. ## `priceFilter` (type: `string`): Keep only games matching this pricing state. "On sale" and "Paid" require Fetch detail pages for reliable results. ## `platforms` (type: `array`): Keep only games available on at least one of the selected platforms. ## `minRating` (type: `number`): Keep only games rated at or above this value (0–5). Requires Fetch detail pages. Unrated games are kept. ## `minPrice` (type: `number`): Keep only games priced at or above this amount (in the game's own currency). Free games are excluded when set above 0. ## `maxPrice` (type: `number`): Keep only games priced at or below this amount (in the game's own currency). ## Actor input object example ```json { "sort": "new-and-popular", "tag": "", "genre": "", "classification": "any", "maxResults": 5, "fetchDetails": false, "startUrls": [], "priceFilter": "all", "platforms": [] } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/itchio-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("unfenced-group/itchio-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 unfenced-group/itchio-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/itchio-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "itch.io Game Scraper", "description": "Scrape indie games from itch.io — prices, sales, ratings, tags, genres, platforms, languages, screenshots and trailers. Browse by sort, tag or genre, or pass game URLs. 30+ fields, from $0.69/1k.", "version": "0.0", "x-build-id": "JuaAXRJ1nVedgWDgn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~itchio-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-itchio-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/unfenced-group~itchio-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-itchio-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/unfenced-group~itchio-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-itchio-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": { "sort": { "title": "Browse mode", "enum": [ "new-and-popular", "newest", "top-rated", "most-popular", "on-sale", "free", "top-sellers" ], "type": "string", "description": "Which itch.io browse list to scrape. Ignored when a Tag, Genre, or Start URLs are provided.", "default": "new-and-popular" }, "tag": { "title": "Tag", "type": "string", "description": "Browse a specific itch.io tag (e.g. \"horror\", \"pixel-art\", \"roguelike\", \"visual-novel\"). Overrides Browse mode.", "default": "" }, "genre": { "title": "Genre", "type": "string", "description": "Browse a specific itch.io genre (e.g. \"action\", \"puzzle\", \"rpg\", \"platformer\", \"shooter\"). Overrides Browse mode (used only if Tag is empty).", "default": "" }, "classification": { "title": "Classification", "enum": [ "any", "game", "tool", "comic", "book", "physical_game", "soundtrack", "game_mod", "assets" ], "type": "string", "description": "Restrict to a project type.", "default": "any" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of games to return.", "default": 5 }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Visit each game's page for the full field set (genre, tags, languages, rating, screenshots, trailer, description, AI disclosure, accessibility, and more). Slower but far richer. Required for the filters below to work on detail-only fields.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of specific itch.io game page URLs to scrape directly (e.g. https://author.itch.io/my-game). When provided, Browse mode / Tag / Genre are ignored. Detail pages are always fetched for Start URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "priceFilter": { "title": "Price filter", "enum": [ "all", "free", "paid", "onSale" ], "type": "string", "description": "Keep only games matching this pricing state. \"On sale\" and \"Paid\" require Fetch detail pages for reliable results.", "default": "all" }, "platforms": { "title": "Platforms", "type": "array", "description": "Keep only games available on at least one of the selected platforms.", "items": { "type": "string", "enum": [ "Windows", "macOS", "Linux", "Android", "Web" ] }, "default": [] }, "minRating": { "title": "Minimum rating", "type": "number", "description": "Keep only games rated at or above this value (0–5). Requires Fetch detail pages. Unrated games are kept." }, "minPrice": { "title": "Minimum price", "type": "number", "description": "Keep only games priced at or above this amount (in the game's own currency). Free games are excluded when set above 0." }, "maxPrice": { "title": "Maximum price", "type": "number", "description": "Keep only games priced at or below this amount (in the game's own currency)." } } }, "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 } } } } } } } } } } ```