TheGamesDB

TheGamesDB Platforms API

The Platforms API from TheGamesDB — 4 operation(s) for platforms.

GitHub OpenAPI

Operations 4

GET /v1/Platforms Fetch platforms list #
GET /v1/Platforms/ByPlatformID Fetch platforms list by id #
GET /v1/Platforms/ByPlatformName Fetch platforms by name #
GET /v1/Platforms/Images Fetch platform(s) images by platform(s) id #

Documentation

📖
Documentation
https://api.thegamesdb.net/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/thegamesdb/openapi/thegamesdb-platforms-api-openapi.yml

Schemas & Data

📊
JSONStructure
https://artifacts.apis.io/thegamesdb/json-structure/thegamesdb-game-structure.json
📊
JSONSchema
https://artifacts.apis.io/thegamesdb/json-schema/thegamesdb-platforms-images-schema.json
📊
JSONSchema
https://artifacts.apis.io/thegamesdb/json-schema/thegamesdb-platforms-schema.json
📊
JSONSchema
https://artifacts.apis.io/thegamesdb/json-schema/thegamesdb-platforms-by-platform-id-schema.json
📊
JSONSchema
https://artifacts.apis.io/thegamesdb/json-schema/thegamesdb-platforms-by-platform-name-schema.json

Other Resources

🔗
Signup
https://api.thegamesdb.net/key.php
🔗
JSONLD
https://artifacts.apis.io/thegamesdb/json-ld/thegamesdb-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/thegamesdb:thegamesdb-platforms-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

thegamesdb-platforms-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: API Documentation
  version: 2.0.0
  title: TheGamesDB Platforms 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: Platforms
paths:
  /v1/Platforms:
    get:
      tags:
      - Platforms
      operationId: Platforms
      summary: Fetch platforms list
      parameters:
      - in: query
        name: apikey
        description: (Required)
        required: true
        schema:
          type: string
      - in: query
        name: fields
        description: '(Optional) - valid `,` delimited options: `icon`, `console`, `controller`, `developer`, `manufacturer`, `media`, `cpu`, `memory`, `graphics`, `sound`, `maxcontrollers`, `display`, `overview`, `youtube`'
        required: false
        schema:
          type: string
      responses:
        200:
          description: result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Platforms'
        400:
          description: bad input parameter
        403:
          description: bad API key or hit rate-limit cap
  /v1/Platforms/ByPlatformID:
    get:
      tags:
      - Platforms
      operationId: PlatformsByPlatformID
      summary: Fetch platforms list by id
      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: integer
      - in: query
        name: fields
        description: '(Optional) - valid `,` delimited options: `icon`, `console`, `controller`, `developer`, `manufacturer`, `media`, `cpu`, `memory`, `graphics`, `sound`, `maxcontrollers`, `display`, `overview`, `youtube`'
        required: false
        schema:
          type: string
      responses:
        200:
          description: result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformsByPlatformID'
        400:
          description: bad input parameter
        403:
          description: bad API key or hit rate-limit cap
  /v1/Platforms/ByPlatformName:
    get:
      tags:
      - Platforms
      operationId: PlatformsByPlatformName
      summary: Fetch platforms by name
      parameters:
      - in: query
        name: apikey
        description: (Required)
        required: true
        schema:
          type: string
      - in: query
        name: name
        description: (Required)
        required: true
        schema:
          type: string
      - in: query
        name: fields
        description: '(Optional) - valid `,` delimited options: `icon`, `console`, `controller`, `developer`, `manufacturer`, `media`, `cpu`, `memory`, `graphics`, `sound`, `maxcontrollers`, `display`, `overview`, `youtube`'
        required: false
        schema:
          type: string
      responses:
        200:
          description: result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformsByPlatformName'
        400:
          description: bad input parameter
        403:
          description: bad API key or hit rate-limit cap
  /v1/Platforms/Images:
    get:
      tags:
      - Platforms
      operationId: PlatformsImages
      summary: Fetch platform(s) images by platform(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: platforms_id
        description: (Required) - platform(s) `id` can be obtain from the above platforms api, supports `,` delimited list
        required: true
        schema:
          type: string
      - in: query
        name: filter[type]
        description: '(Optional) - valid `,` delimited options: `fanart`, `banner`, `boxart`'
        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/PlatformsImages'
        400:
          description: bad input parameter
        403:
          description: bad API key or hit rate-limit cap
components:
  schemas:
    Platforms:
      allOf:
      - $ref: '#/components/schemas/BaseApiResponse'
      - type: object
        required:
        - data
        properties:
          data:
            type: object
            required:
            - count
            - platforms
            properties:
              count:
                type: integer
                minimum: 0
              platforms:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/Platform'
    Platform:
      type: object
      required:
      - id
      - name
      - alias
      - icon
      - console
      - controller
      - developer
      properties:
        id:
          type: integer
          minimum: 0
        name:
          type: string
        alias:
          type: string
        icon:
          type: string
        console:
          type: string
        controller:
          type: string
        developer:
          type: string
        overview:
          type: string
      example:
        id: 25
        name: 3DO
        alias: 3do
        icon: 3do-1336524121.png
        console: 25.png
        controller: ''
        developer: The 3DO Company
    PlatformsByPlatformID:
      allOf:
      - $ref: '#/components/schemas/BaseApiResponse'
      - type: object
        required:
        - data
        properties:
          data:
            type: object
            required:
            - count
            - platforms
            properties:
              count:
                type: integer
                minimum: 0
              platforms:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/Platform'
    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: ''
    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/
    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
    PlatformsImages:
      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/PlatformImage'
    PlatformsByPlatformName:
      allOf:
      - $ref: '#/components/schemas/BaseApiResponse'
      - type: object
        required:
        - data
        properties:
          data:
            type: object
            required:
            - count
            - platforms
            properties:
              count:
                type: integer
                minimum: 0
              platforms:
                type: array
                items:
                  $ref: '#/components/schemas/Platform'
    PlatformImage:
      type: object
      properties:
        id:
          type: integer
          minimum: 0
        type:
          type: string
        filename:
          type: string
      example:
        id: 72
        type: fanart
        filename: platform/fanart/12-1.jpg