Game

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.itch.io/schemas/game.json",
  "title": "Game",
  "description": "Represents a page on itch.io — a game, tool, comic, book, soundtrack, or other creative work published by a developer.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Site-wide unique identifier generated by itch.io"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Canonical address of the game's page on itch.io"
    },
    "title": {
      "type": "string",
      "description": "Human-friendly title; may contain any character"
    },
    "shortText": {
      "type": "string",
      "description": "Human-friendly short description"
    },
    "type": {
      "type": "string",
      "enum": ["default", "flash", "unity", "java", "html"],
      "description": "Type of the game page: downloadable or embedded"
    },
    "classification": {
      "type": "string",
      "enum": ["game", "tool", "assets", "game_mod", "physical_game", "soundtrack", "other", "comic", "book"],
      "description": "Creator-picked classification for the page"
    },
    "embed": {
      "type": "object",
      "description": "Configuration for embedded (HTML5) games",
      "properties": {
        "gameId": { "type": "integer" },
        "width": { "type": "integer", "description": "Width of the initial viewport in pixels" },
        "height": { "type": "integer", "description": "Height of the initial viewport in pixels" },
        "fullscreen": { "type": "boolean", "description": "Whether a fullscreen button should be shown" }
      }
    },
    "coverUrl": {
      "type": "string",
      "format": "uri",
      "description": "Cover URL; might be a GIF"
    },
    "stillCoverUrl": {
      "type": "string",
      "format": "uri",
      "description": "Non-animated cover URL; only set when coverUrl is a GIF"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "RFC 3339 timestamp when the game page was created"
    },
    "publishedAt": {
      "type": ["string", "null"],
      "format": "date-time",
      "description": "RFC 3339 timestamp when the game was published; null if not published"
    },
    "minPrice": {
      "type": "integer",
      "description": "Minimum price in cents of a dollar (0 = free)"
    },
    "canBeBought": {
      "type": "boolean",
      "description": "Whether payments are accepted for this game"
    },
    "hasDemo": {
      "type": "boolean",
      "description": "Whether a free demo is available"
    },
    "inPressSystem": {
      "type": "boolean",
      "description": "Whether this game is part of the itch.io press system"
    },
    "platforms": {
      "type": "object",
      "description": "Platforms this game is available for",
      "properties": {
        "windows": { "type": "string", "enum": ["all", "386", "amd64"] },
        "linux":   { "type": "string", "enum": ["all", "386", "amd64"] },
        "osx":     { "type": "string", "enum": ["all", "386", "amd64"] }
      }
    },
    "user": {
      "$ref": "user.json",
      "description": "The user account this game is associated to"
    },
    "userId": {
      "type": "integer",
      "description": "ID of the user account this game is associated to"
    },
    "sale": {
      "type": ["object", "null"],
      "description": "The best current sale for this game",
      "properties": {
        "id": { "type": "integer" },
        "gameId": { "type": "integer" },
        "rate": { "type": "number", "description": "Discount rate in percent; may be negative (reverse sale)" },
        "startDate": { "type": "string", "format": "date-time" },
        "endDate": { "type": "string", "format": "date-time" }
      }
    },
    "viewsCount": {
      "type": "integer",
      "description": "Owner-only: total view count"
    },
    "downloadsCount": {
      "type": "integer",
      "description": "Owner-only: total download count"
    },
    "purchasesCount": {
      "type": "integer",
      "description": "Owner-only: total purchase count"
    },
    "published": {
      "type": "boolean",
      "description": "Owner-only: whether the game is currently published"
    }
  },
  "required": ["id"]
}