The Games API from TheGamesDB — 6 operation(s) for games.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/thegamesdb-games-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: API Documentation
version: 2.0.0
title: TheGamesDB Developers Games API
license:
name: GNU General Public License v3.0
url: https://github.com/TheGamesDB/TheGamesDBv2/blob/master/LICENSE
servers:
- url: https://api.thegamesdb.net/
tags:
- name: Games
paths:
/v1/Games/ByGameID:
get:
tags:
- Games
operationId: GamesByGameID
summary: Fetch game(s) by id
description: can request additional information can be requestes through `fields` and `include` params
parameters:
- in: query
name: apikey
description: (Required)
required: true
schema:
type: string
- in: query
name: id
description: (Required) - supports `,` delimited list
required: true
schema:
type: string
- in: query
name: fields
description: '(Optional) - valid `,` delimited options: `players`, `publishers`, `genres`, `overview`, `last_updated`, `rating`, `platform`, `coop`, `youtube`, `os`, `processor`, `ram`, `hdd`, `video`, `sound`, `alternates`'
required: false
schema:
type: string
- in: query
name: include
description: '(Optional) - valid `,` delimited options: `boxart`, `platform`'
required: false
schema:
type: string
- in: query
name: page
description: (Optional) - results page offset to return
required: false
schema:
type: integer
responses:
200:
description: result
content:
application/json:
schema:
$ref: '#/components/schemas/GamesByGameID'
400:
description: bad input parameter
403:
description: bad API key or hit rate-limit cap
/v1/Games/ByGameName:
get:
tags:
- Games
operationId: GamesByGameName_v1
summary: Fetch game(s) by name
description: can request additional information can be requestes through `fields` and `include` params
parameters:
- in: query
name: apikey
description: (Required)
required: true
schema:
type: string
- in: query
name: name
description: (Required) - Search term
required: true
schema:
type: string
- in: query
name: fields
description: '(Optional) - valid `,` delimited options: `players`, `publishers`, `genres`, `overview`, `last_updated`, `rating`, `platform`, `coop`, `youtube`, `os`, `processor`, `ram`, `hdd`, `video`, `sound`, `alternates`'
required: false
schema:
type: string
- in: query
name: filter[platform]
description: (Optional) - platform `id` can be obtain from the platforms api below, supports `,` delimited list
required: false
schema:
type: string
- in: query
name: include
description: '(Optional) - valid `,` delimited options: `boxart`, `platform`'
required: false
schema:
type: string
- in: query
name: page
description: (Optional) - results page offset to return
required: false
schema:
type: integer
responses:
200:
description: result
content:
application/json:
schema:
$ref: '#/components/schemas/GamesByGameID_v1'
400:
description: bad input parameter
403:
description: bad API key or hit rate-limit cap
/v1.1/Games/ByGameName:
get:
tags:
- Games
operationId: GamesByGameName
summary: Fetch game(s) by name
description: can request additional information can be requestes through `fields` and `include` params
parameters:
- in: query
name: apikey
description: (Required)
required: true
schema:
type: string
- in: query
name: name
description: (Required) - Search term
required: true
schema:
type: string
- in: query
name: fields
description: '(Optional) - valid `,` delimited options: `players`, `publishers`, `genres`, `overview`, `last_updated`, `rating`, `platform`, `coop`, `youtube`, `os`, `processor`, `ram`, `hdd`, `video`, `sound`, `alternates`'
required: false
schema:
type: string
- in: query
name: filter[platform]
description: (Optional) - platform `id` can be obtain from the platforms api below, supports `,` delimited list
required: false
schema:
type: string
- in: query
name: include
description: '(Optional) - valid `,` delimited options: `boxart`, `platform`'
required: false
schema:
type: string
- in: query
name: page
description: (Optional) - results page offset to return
required: false
schema:
type: integer
responses:
200:
description: result
content:
application/json:
schema:
$ref: '#/components/schemas/GamesByGameID'
400:
description: bad input parameter
403:
description: bad API key or hit rate-limit cap
/v1/Games/ByPlatformID:
get:
tags:
- Games
operationId: GamesByPlatformID
summary: Fetch game(s) by platform id
description: can request additional information can be requested through `fields` and `include` params
parameters:
- in: query
name: apikey
description: (Required)
required: true
schema:
type: string
- in: query
name: id
description: (Required) - platform `id` can be obtain from the platforms api below, supports `,` delimited list
required: true
schema:
type: string
- in: query
name: fields
description: '(Optional) - valid `,` delimited options: `players`, `publishers`, `genres`, `overview`, `last_updated`, `rating`, `platform`, `coop`, `youtube`, `os`, `processor`, `ram`, `hdd`, `video`, `sound`, `alternates`'
required: false
schema:
type: string
- in: query
name: include
description: '(Optional) - valid `,` delimited options: `boxart`, `platform`'
required: false
schema:
type: string
- in: query
name: page
description: (Optional) - results page offset to return
required: false
schema:
type: integer
responses:
200:
description: result
content:
application/json:
schema:
$ref: '#/components/schemas/GamesByGameID'
400:
description: bad input parameter
403:
description: bad API key or hit rate-limit cap
/v1/Games/Images:
get:
tags:
- Games
operationId: GamesImages
summary: Fetch game(s) images by game(s) id
description: results can be filtered with `filter[type]` param
parameters:
- in: query
name: apikey
description: (Required)
required: true
schema:
type: string
- in: query
name: games_id
description: (Required) - game(s) `id` can be obtain from the above games api, supports `,` delimited list
required: true
schema:
type: string
- in: query
name: filter[type]
description: '(Optional) - valid `,` delimited options: `fanart`, `banner`, `boxart`, `screenshot`, `clearlogo`, `titlescreen`'
required: false
schema:
type: string
- in: query
name: page
description: (Optional) - results page offset to return
required: false
schema:
type: integer
responses:
200:
description: result
content:
application/json:
schema:
$ref: '#/components/schemas/GamesImages'
400:
description: bad input parameter
403:
description: bad API key or hit rate-limit cap
/v1/Games/Updates:
get:
tags:
- Games
operationId: GamesUpdates
summary: Fetch games update
parameters:
- in: query
name: apikey
description: (Required)
required: true
schema:
type: string
- in: query
name: last_edit_id
description: (Required)
required: true
schema:
type: integer
- in: query
name: time
description: (Optional)
required: false
schema:
type: integer
- in: query
name: page
description: (Optional) - results page offset to return
required: false
schema:
type: integer
responses:
200:
description: result
content:
application/json:
schema:
$ref: '#/components/schemas/GamesUpdates'
400:
description: bad input parameter
403:
description: bad API key or hit rate-limit cap
components:
schemas:
GamesByGameID:
allOf:
- $ref: '#/components/schemas/PaginatedApiResponse'
- type: object
required:
- data
- include
properties:
data:
type: object
required:
- count
- games
properties:
count:
type: integer
minimum: 0
games:
type: array
items:
$ref: '#/components/schemas/Game'
include:
type: object
required:
- boxart
- platform
properties:
boxart:
type: object
required:
- base_url
- data
properties:
base_url:
$ref: '#/components/schemas/ImageBaseUrlMeta'
data:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/GameImage'
platform:
type: object
required:
- data
properties:
data:
type: object
additionalProperties:
$ref: '#/components/schemas/PlatformSkinny'
PaginatedApiResponse:
allOf:
- $ref: '#/components/schemas/BaseApiResponse'
- type: object
required:
- pages
properties:
pages:
type: object
required:
- previous
- current
- next
properties:
previous:
type: string
current:
type: string
next:
type: string
example:
previous: ''
current: https://api.thegamesdb.net/Games/ByGameID?apikey=APIKEY&id=1%2C2%2C3%2C4&fields=players%2Cpublishers%2Cgenres%2Coverview%2Clast_updated%2Crating%2Cplatform%2Ccoop%2Cyoutube%2Cos%2Cprocessor%2Cram%2Chdd%2Cvideo%2Csound%2Calternates&include=boxart%2Cplatform&page=1
next: ''
BaseApiResponse:
type: object
required:
- code
- status
- remaining_monthly_allowance
- extra_allowance
properties:
code:
type: integer
minimum: 0
status:
type: string
remaining_monthly_allowance:
type: integer
minimum: 0
extra_allowance:
type: integer
minimum: 0
example:
code: 200
status: Success
remaining_monthly_allowance: 257
extra_allowance: 0
GamesByGameID_v1:
allOf:
- $ref: '#/components/schemas/PaginatedApiResponse'
- type: object
required:
- data
- include
properties:
data:
type: object
required:
- count
- games
properties:
count:
type: integer
minimum: 0
games:
type: array
items:
$ref: '#/components/schemas/Game'
include:
type: object
required:
- boxart
- platform
properties:
boxart:
type: object
required:
- base_url
- data
properties:
base_url:
$ref: '#/components/schemas/ImageBaseUrlMeta'
data:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/GameImage'
platform:
type: object
additionalProperties:
$ref: '#/components/schemas/PlatformSkinny'
Game:
type: object
properties:
id:
type: integer
minimum: 0
game_title:
type: string
release_date:
type: string
platform:
type: integer
minimum: 0
players:
type: integer
minimum: 0
overview:
type: string
last_updated:
type: string
rating:
type: string
coop:
type: string
youtube:
type: string
os:
type: string
processor:
type: string
ram:
type: string
hdd:
type: string
video:
type: string
sound:
type: string
developers:
type: array
items:
type: integer
minimum: 0
genres:
type: array
items:
type: integer
minimum: 0
publishers:
type: array
items:
type: integer
minimum: 0
alternates:
type: array
items:
type: string
example:
id: 4
game_title: Star Fox 64
release_date: '1997-06-30'
platform: 3
players: 4
overview: The Lylat system has been invaded! Join Fox McCloud and his Star Fox team as they fight to save the galaxy from the clutches of the...
last_updated: '2018-08-11 15:01:11'
rating: E - Everyone
coop: 'No'
youtube: jsEcmfPwnHo
os: null
processor: null
ram: null
hdd: null
video: null
sound: null
developers:
- 6037
genres:
- 1
- 8
publishers:
- 3
alternates:
- Lylat Wars (EU)
- Lylat Wars
GamesImages:
allOf:
- $ref: '#/components/schemas/PaginatedApiResponse'
- type: object
required:
- data
properties:
data:
type: object
required:
- count
- base_url
- images
properties:
count:
type: integer
minimum: 0
base_url:
$ref: '#/components/schemas/ImageBaseUrlMeta'
images:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/GameImage'
UpdateModel:
type: object
properties:
edit_id:
type: integer
minimum: 0
game_id:
type: integer
minimum: 0
timestamp:
type: string
type:
type: string
value:
type: string
example:
edit_id: 23159
game_id: 60901
timestamp: '2018-09-05 21:21:27'
type: boxart
value: boxart/front/60901-1.jpg
ImageBaseUrlMeta:
type: object
required:
- original
- small
- thumb
- cropped_center_thumb
- medium
- large
properties:
original:
type: string
small:
type: string
thumb:
type: string
cropped_center_thumb:
type: string
medium:
type: string
large:
type: string
example:
original: https://cdn.thegamsdb.net/images/original/
small: https://cdn.thegamsdb.net/images/small/
thumb: https://cdn.thegamsdb.net/images/thumb/
cropped_center_thumb: https://cdn.thegamsdb.net/images/cropped_center_thumb/
medium: https://cdn.thegamsdb.net/images/medium/
large: https://cdn.thegamsdb.net/images/large/
PlatformSkinny:
type: object
required:
- id
- name
- alias
properties:
id:
type: integer
minimum: 0
name:
type: string
alias:
type: string
example:
id: 3
name: Nintendo 64
alias: nintendo-64
GamesUpdates:
allOf:
- $ref: '#/components/schemas/PaginatedApiResponse'
- type: object
required:
- data
properties:
data:
type: object
required:
- count
- updates
properties:
count:
type: integer
minimum: 0
updates:
type: array
items:
$ref: '#/components/schemas/UpdateModel'
GameImage:
type: object
properties:
id:
type: integer
minimum: 0
type:
type: string
side:
type: string
filename:
type: string
resolution:
type: string
example:
id: 23413
type: boxart
side: front
filename: boxart/front/1-1.jpg
resolution: 1529x2156