{
  "openapi": "3.1.0",
  "info": {
    "title": "Video Games API",
    "version": "1.0.0",
    "description": "31,336 video games from Wikidata, CC0, with platforms, genres, developers, publishers and Steam app ids.\n\nVideo game metadata you can build a product on without a licensing bill: 31,336 games — every one with an English Wikipedia article — from Wikidata, CC0 public domain. Each game carries release year, platforms, genres, game modes, developers, publishers, series, official website, a notability rank and, for 8,369 titles, the Steam application id — resolve appid 1145360 to Hades (Supergiant Games, 2020) in one call. Search is token full-text (\"breath of the wild\" finds the Zelda you mean) with filters that answer real product questions: FromSoftware''s catalog led by Elden Ring, all 38 Legend of Zelda games, or every PlayStation 5 role-playing game since 2020 (Genshin Impact, Cyberpunk 2077, Elden Ring lead the 278). Famous games rank first everywhere via cross-wiki sitelink counts. New releases sync daily from Wikidata as they gain Wikipedia articles, and re-syncs fill in metadata as editors add it. Built for game discovery apps, Discord bots, backlog trackers, deal sites and gaming media. CC0 source data, self-hosted — no third-party calls at request time.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/video-games.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/video-games"
  },
  "servers": [
    {
      "url": "https://api-video-games.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Entertainment",
      "description": "Video Games API belongs to the Entertainment category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/sources": {
      "get": {
        "operationId": "dataSources",
        "summary": "Data Sources",
        "description": "Data Sources endpoint of the Video Games API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/video-games/data-sources"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "attribution": "Data from Wikidata (CC0)",
                  "count": 1,
                  "sources": [
                    {
                      "slug": "wikidata-games",
                      "name": "Wikidata video games (enwiki subset)",
                      "publisher": "Wikidata contributors",
                      "licence": "CC0 1.0 (public domain dedication)",
                      "source_url": "https://www.wikidata.org/",
                      "file_url": "https://query.wikidata.org/sparql",
                      "cadence": "daily new-release refresh",
                      "record_count": 31336,
                      "retrieved_at": "2026-09-05"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/games/{qid}": {
      "get": {
        "operationId": "getGame",
        "summary": "Get Game",
        "description": "Get Game endpoint of the Video Games API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/video-games/get-game"
        },
        "parameters": [
          {
            "name": "qid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Q49740"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "game": {
                    "qid": "Q49740",
                    "title": "Minecraft",
                    "description": "2011 video game",
                    "year": 2011,
                    "platforms": [
                      "Android",
                      "Linux",
                      "Microsoft Windows",
                      "PlayStation 3",
                      "macOS",
                      "ARM architecture",
                      "Xbox 360",
                      "iOS"
                    ],
                    "genres": [
                      "action-adventure game",
                      "construction and management simulation",
                      "survival game",
                      "sandbox game",
                      "retro-style video game"
                    ],
                    "game_modes": [
                      "single-player video game",
                      "multiplayer video game"
                    ],
                    "developers": [
                      "Microsoft",
                      "Mojang Studios"
                    ],
                    "publishers": [
                      "Xbox Game Studios"
                    ],
                    "series": "Minecraft",
                    "steam_appid": null,
                    "website": "https://minecraft.net",
                    "wikipedia": "https://en.wikipedia.org/wiki/Minecraft",
                    "notability_rank": 156
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/games/steam/{appid}": {
      "get": {
        "operationId": "lookupBySteamAppId",
        "summary": "Lookup By Steam App ID",
        "description": "Lookup By Steam App ID endpoint of the Video Games API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/video-games/lookup-by-steam-app-id"
        },
        "parameters": [
          {
            "name": "appid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1145360"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "game": {
                    "qid": "Q59756366",
                    "title": "Hades",
                    "description": "2020 action role-playing game developed by Supergiant Games",
                    "year": 2020,
                    "platforms": [
                      "Microsoft Windows",
                      "macOS",
                      "PlayStation 4",
                      "Xbox One",
                      "Nintendo Switch",
                      "PlayStation 5",
                      "Xbox Series X and Series S"
                    ],
                    "genres": [
                      "roguelike",
                      "action role-playing game",
                      "roguelite"
                    ],
                    "game_modes": [
                      "single-player video game"
                    ],
                    "developers": [
                      "Supergiant Games"
                    ],
                    "publishers": [
                      "Supergiant Games"
                    ],
                    "series": "Hades",
                    "steam_appid": "1145360",
                    "website": "https://www.supergiantgames.com/games/hades",
                    "wikipedia": "https://en.wikipedia.org/wiki/Hades_(video_game)",
                    "notability_rank": 31
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/games/random": {
      "get": {
        "operationId": "randomGame",
        "summary": "Random Game",
        "description": "Random Game endpoint of the Video Games API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/video-games/random-game"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "game": {
                    "qid": "Q1058903",
                    "title": "Super Mario All-Stars",
                    "description": "1993 video game developed by Nintendo Entertainment Analysis & Development",
                    "year": 1993,
                    "platforms": [
                      "Wii",
                      "Super Nintendo Entertainment System",
                      "Nintendo Switch"
                    ],
                    "genres": [
                      "platformer"
                    ],
                    "game_modes": [
                      "single-player video game",
                      "multiplayer video game"
                    ],
                    "developers": [
                      "Nintendo",
                      "Nintendo Entertainment Analysis & Development"
                    ],
                    "publishers": [
                      "Nintendo"
                    ],
                    "series": "Super Mario",
                    "steam_appid": null,
                    "website": null,
                    "wikipedia": "https://en.wikipedia.org/wiki/Super_Mario_All-Stars",
                    "notability_rank": 27
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/games": {
      "get": {
        "operationId": "searchGames",
        "summary": "Search Games",
        "description": "Search Games endpoint of the Video Games API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/video-games/search-games"
        },
        "parameters": [
          {
            "name": "developer",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "genre",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "publisher",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Nintendo"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "breath of the wild"
          },
          {
            "name": "series",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Zelda"
          },
          {
            "name": "year_from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year_to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "total": 1,
                  "page": 1,
                  "limit": 20,
                  "count": 1,
                  "results": [
                    {
                      "qid": "Q17185964",
                      "title": "The Legend of Zelda: Breath of the Wild",
                      "year": 2017,
                      "platforms": [
                        "Wii U",
                        "Nintendo Switch",
                        "Nintendo Switch 2"
                      ],
                      "genres": [
                        "action-adventure game",
                        "role-playing video game",
                        "post-apocalyptic video game"
                      ],
                      "developers": [
                        "Monolith Soft Inc.",
                        "Nintendo Entertainment Planning & Development"
                      ],
                      "steam_appid": null
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}