TheGamesDB · Schema

Game

Video game details

DatabaseGamingVideo GamesMetadataArtwork

Properties

Name Type Description
id integer Unique game identifier
game_title string Official game title
release_date string Release date
platform integer Platform ID
region_id integer Region identifier
country_id integer Country identifier
overview string Game description/overview
youtube string YouTube trailer URL
players integer Number of players supported
coop string Co-operative play supported
rating string Content rating (ESRB, PEGI, etc.)
alternates array Alternate game titles
View JSON Schema on GitHub

JSON Schema

thegamesdb-game-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/thegamesdb/refs/heads/main/json-schema/thegamesdb-game-schema.json",
  "title": "Game",
  "description": "Video game details",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Unique game identifier",
      "example": 1
    },
    "game_title": {
      "type": "string",
      "description": "Official game title",
      "example": "Halo: Combat Evolved"
    },
    "release_date": {
      "type": "string",
      "description": "Release date",
      "example": "2001-11-15"
    },
    "platform": {
      "type": "integer",
      "description": "Platform ID",
      "example": 14
    },
    "region_id": {
      "type": "integer",
      "description": "Region identifier",
      "nullable": true
    },
    "country_id": {
      "type": "integer",
      "description": "Country identifier",
      "nullable": true
    },
    "overview": {
      "type": "string",
      "description": "Game description/overview",
      "nullable": true
    },
    "youtube": {
      "type": "string",
      "description": "YouTube trailer URL",
      "nullable": true
    },
    "players": {
      "type": "integer",
      "description": "Number of players supported",
      "nullable": true
    },
    "coop": {
      "type": "string",
      "description": "Co-operative play supported",
      "nullable": true
    },
    "rating": {
      "type": "string",
      "description": "Content rating (ESRB, PEGI, etc.)",
      "nullable": true
    },
    "alternates": {
      "type": "array",
      "description": "Alternate game titles",
      "nullable": true,
      "items": {
        "type": "string"
      }
    }
  }
}