TheGamesDB
An open, online database for video game fans providing game information, artwork, and metadata via API.
1 APIs
7 Features
DatabaseGamingVideo GamesMetadataArtwork
Game Search
Search games by name with optional platform filtering
Game Details
Retrieve complete game metadata by ID including overview, ratings, and system requirements
Platform Catalog
Full catalog of all gaming platforms with hardware specifications and images
Game Artwork
Boxart, screenshots, fanart, banners, and clearlogos for games and platforms
Game Updates
Retrieve games updated since a given timestamp for database synchronization
Reference Data
Complete lists of genres, developers, and publishers
Batch Requests
Request multiple game or platform IDs in a single API call
Gaming Applications
Build game databases, libraries, and collection managers
Media Centers
Power game scrapers for Emulation Station, Kodi, and similar media centers
Game Collections
Manage personal or commercial video game collection databases
AI Game Assistant
Power AI agents that answer questions about video games
opencollection: 1.0.0
info:
name: TheGamesDB API
version: 2.0.0
items:
- info:
name: Games
type: folder
items:
- info:
name: TheGamesDB Fetch Games by ID
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Games/ByGameID
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: id
value: ''
type: query
description: Game ID or comma-delimited list of game IDs
- name: fields
value: ''
type: query
description: 'Comma-delimited optional fields: players, publishers, genres, overview, last_updated, rating, platform,
coop, youtube, os, processor, ram, hdd, video, sound, alternates'
- name: include
value: ''
type: query
description: 'Comma-delimited optional includes: boxart, platform'
- name: page
value: ''
type: query
description: Results page offset to return
docs: Fetch game details by one or more game IDs. Additional fields can be requested via 'fields' parameter. Related data
like boxart and platform information can be included via 'include' parameter.
- info:
name: TheGamesDB Fetch Games by Name (v1)
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Games/ByGameName
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: name
value: ''
type: query
description: Game name search term
- name: fields
value: ''
type: query
description: 'Comma-delimited optional fields: players, publishers, genres, overview, last_updated, rating, platform,
coop, youtube, os, processor, ram, hdd, video, sound, alternates'
- name: filter[platform]
value: ''
type: query
description: Filter by platform ID (comma-delimited list)
- name: include
value: ''
type: query
description: 'Comma-delimited optional includes: boxart, platform'
- name: page
value: ''
type: query
description: Results page offset
docs: Search for games by name. Returns games matching the search term. Additional fields and includes available.
- info:
name: TheGamesDB Fetch Games by Name (v1.1)
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1.1/Games/ByGameName
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: name
value: ''
type: query
description: Game name search term
- name: fields
value: ''
type: query
description: Comma-delimited optional fields
- name: filter[platform]
value: ''
type: query
description: Filter by platform ID (comma-delimited)
- name: include
value: ''
type: query
description: 'Comma-delimited optional includes: boxart, platform'
- name: page
value: ''
type: query
description: Results page offset
docs: Search for games by name (v1.1 with improved result format). Returns games matching the search term with additional
metadata.
- info:
name: TheGamesDB Fetch Games by Platform ID
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Games/ByPlatformID
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: id
value: ''
type: query
description: Platform ID or comma-delimited list of platform IDs
- name: fields
value: ''
type: query
description: Comma-delimited optional fields
- name: include
value: ''
type: query
description: 'Comma-delimited optional includes: boxart, platform'
- name: page
value: ''
type: query
description: Results page offset
docs: Fetch games associated with one or more platform IDs. Useful for browsing all games for a specific console or gaming
system.
- info:
name: TheGamesDB Fetch Game Images
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Games/Images
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: games_id
value: ''
type: query
description: Game ID or comma-delimited list of game IDs
- name: filter[type]
value: ''
type: query
description: Filter by image type (boxart, screenshot, fanart, banner, clearlogo)
- name: page
value: ''
type: query
description: Results page offset
docs: Retrieve artwork and images for one or more games by game ID. Returns boxart, screenshots, fanart, banners, and
clearlogos.
- info:
name: TheGamesDB Fetch Games Updated Since Timestamp
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Games/Updates
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: last_edit_id
value: ''
type: query
description: Unix timestamp to fetch updates since
- name: time
value: ''
type: query
description: Unix timestamp for filtering
- name: page
value: ''
type: query
description: Results page offset
docs: Fetch a list of games that have been updated since a given Unix timestamp. Useful for syncing local databases.
- info:
name: Platforms
type: folder
items:
- info:
name: TheGamesDB Fetch All Platforms
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Platforms
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: fields
value: ''
type: query
description: 'Comma-delimited optional fields: icon, console, controller, developer, manufacturer, media, cpu, memory,
graphics, sound, maxcontrollers, display, overview, youtube'
docs: Retrieve a list of all gaming platforms in the database with their IDs, names, and metadata.
- info:
name: TheGamesDB Fetch Platforms by ID
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Platforms/ByPlatformID
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: id
value: ''
type: query
description: Platform ID or comma-delimited list of platform IDs
- name: fields
value: ''
type: query
description: Comma-delimited optional platform detail fields
docs: Retrieve details for specific gaming platforms by their IDs.
- info:
name: TheGamesDB Fetch Platforms by Name
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Platforms/ByPlatformName
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: name
value: ''
type: query
description: Platform name to search
- name: fields
value: ''
type: query
description: Comma-delimited optional platform detail fields
docs: Search for gaming platforms by name.
- info:
name: TheGamesDB Fetch Platform Images
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Platforms/Images
params:
- name: apikey
value: ''
type: query
description: API key (required)
- name: platforms_id
value: ''
type: query
description: Platform ID or comma-delimited list of platform IDs
- name: filter[type]
value: ''
type: query
description: Filter by image type (fanart, banner, boxart)
- name: page
value: ''
type: query
description: Results page offset
docs: Retrieve artwork and images for one or more gaming platforms by platform ID.
- info:
name: Genres
type: folder
items:
- info:
name: TheGamesDB Fetch All Genres
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Genres
params:
- name: apikey
value: ''
type: query
description: API key (required)
docs: Retrieve a list of all game genres in the database.
- info:
name: Developers
type: folder
items:
- info:
name: TheGamesDB Fetch All Developers
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Developers
params:
- name: apikey
value: ''
type: query
description: API key (required)
docs: Retrieve a list of all game developers in the database.
- info:
name: Publishers
type: folder
items:
- info:
name: TheGamesDB Fetch All Publishers
type: http
http:
method: GET
url: https://api.thegamesdb.net/v1/Publishers
params:
- name: apikey
value: ''
type: query
description: API key (required)
docs: Retrieve a list of all game publishers in the database.
bundled: true
