{ "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 } } } } } } } } } }