{
  "openapi": "3.0.1",
  "info": {
    "title": "itch.io Game Assets Scraper",
    "description": "Scrape game asset listings from itch.io - the open marketplace for indie games and game assets. Browse by tag (animation, 2D, 3D, characters, audio, etc.) or by category (new & popular, top rated, etc.). Returns asset name, author, price, description, tags, and URL.",
    "version": "1.0",
    "x-build-id": "bcPCdpE0fWPGPHYui"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~itch-io-game-assets-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-itch-io-game-assets-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/crawlerbros~itch-io-game-assets-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-itch-io-game-assets-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/crawlerbros~itch-io-game-assets-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-itch-io-game-assets-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "browse",
              "byTag",
              "search",
              "byUrl"
            ],
            "type": "string",
            "description": "Scraping mode: 'browse' for popular assets, 'byTag' for tag-based browsing, 'search' for keyword search.",
            "default": "browse"
          },
          "startUrls": {
            "title": "Listing URLs",
            "type": "array",
            "description": "Direct itch.io listing URLs to scrape full detail records for (used in 'byUrl' mode), e.g. 'https://limezu.itch.io/moderninteriors'. Required when Mode is 'Look up specific listing URL(s)'.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "query": {
            "title": "Search Query",
            "type": "string",
            "description": "Keyword to search for (used in 'search' mode), e.g. 'pixel dungeon' or 'RPG tileset'. Required when Mode is 'Search by keyword'. Results are scoped to itch.io's Game assets classification only.",
            "default": ""
          },
          "tag": {
            "title": "Tag",
            "enum": [
              "animation",
              "2d",
              "3d",
              "character",
              "audio",
              "pixel-art",
              "tileset",
              "ui",
              "font",
              "vfx",
              "rpg",
              "sprite",
              "platformer",
              "texture",
              "fantasy",
              "sci-fi",
              "music",
              "sound-effects",
              "top-down",
              "isometric",
              "unity",
              "godot",
              "horror",
              "puzzle",
              "adventure",
              "medieval",
              "16x16",
              "32x32",
              "8x8",
              "asset-pack",
              "backgrounds",
              "blender",
              "brushes",
              "buttons",
              "endesga-32",
              "fbx",
              "gui",
              "icons",
              "low-poly",
              "materials",
              "models",
              "modern",
              "modular",
              "music-production",
              "pbr",
              "picocad",
              "png",
              "royalty-free",
              "shaders",
              "svg",
              "template",
              "tilemap",
              "vehicles",
              "voxel",
              "vrchat",
              "wav",
              "weapons",
              "8-bit",
              "16-bit",
              "1-bit",
              "futuristic",
              "gothic",
              "cute",
              "retro",
              "unreal-engine",
              "midi",
              "no-ai"
            ],
            "type": "string",
            "description": "Filter assets by itch.io tag (used in 'byTag' mode). E.g. 'animation', '2d', 'character', 'audio'.",
            "default": "animation"
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "popular",
              "new-and-popular",
              "top-sellers",
              "top-rated",
              "newest"
            ],
            "type": "string",
            "description": "How to sort results. Ignored if 'AI Content' or 'Filter By' is set (those take precedence, in that order).",
            "default": "popular"
          },
          "filterBy": {
            "title": "Filter By (price / recency)",
            "enum": [
              "",
              "free",
              "on-sale",
              "store",
              "5-dollars-or-less",
              "15-dollars-or-less",
              "last-day",
              "last-7-days",
              "last-30-days"
            ],
            "type": "string",
            "description": "Optional price or recency filter, combinable with 'Tag' (used in 'byTag' mode). When set, this takes precedence over 'Sort By', but is overridden by 'AI Content' if that is also set.",
            "default": ""
          },
          "aiContent": {
            "title": "AI Content",
            "enum": [
              "",
              "ai-assisted",
              "ai-graphics",
              "ai-audio",
              "ai-text",
              "ai-code"
            ],
            "type": "string",
            "description": "Optional AI-assistance filter (used in 'browse'/'byTag' modes), combinable with 'Tag'. Takes precedence over both 'Sort By' and 'Filter By' when set.",
            "default": ""
          },
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum number of assets to return (or, in 'byUrl' mode, the max number of listing URLs to look up). Min 1, max 200.",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}