Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

IGDB Reference API

Reference data such as keywords, collections, and franchises.

IGDB Reference API is one of 8 APIs that IGDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reference. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

This API exposes 6 operations across 6 paths, and defines 2 schemas. It is described by OpenAPI 3.0.3, at version 4.0.

Requests are made against a single base URL, https://api.igdb.com/v4.

6 operations 6 paths 2 schemas 6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
4.0
Base URL
https://api.igdb.com/v4
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

IGDB Reference API declares 2 security schemes for authenticating requests. An API key is passed in the header as Client-ID (ClientID). It accepts HTTP bearer tokens (OAuth2 access token) (BearerAuth). By default, every request must be authenticated.

  • ClientID — Twitch developer Client-ID issued for the IGDB API.
  • BearerAuth — Bearer access token obtained via the Twitch OAuth Client Credentials flow.

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 POST. Each is listed below with its method, path, parameters, and response codes.

Reference 6

Reference data such as keywords, collections, and franchises.

POST
/game_modes
Query game modes
body → 200401
POST
/collections
Query collections
body → 200401
POST
/franchises
Query franchises
body → 200401
POST
/keywords
Query keywords
body → 200401
POST
/age_ratings
Query age ratings
body → 200401
POST
/websites
Query game websites
body → 200401

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed is Error (3 properties). Each schema is shown below with its type and property counts.

ApicalypseQuery
string
Apicalypse query string used to filter, sort, paginate, and select fields on IGDB resources. Example: fields name,cover.url; where rating 80; limit 10;
Error
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

igdb-reference-api-openapi.yml Raw ↑

Other APIs IGDB publishes across the network.

IGDB Companies API
IGDB Games API
IGDB Genres API
IGDB Media API
IGDB Platforms API
IGDB Releases API
IGDB Search API