Docs
Open Lodol
DocumentationIntegrationsAPI

IGDB

App · Gaming · 4 actions

Search IGDB's video game database for titles, ratings, platforms, and studios, and track what's coming out next.

Actions

ActionWhat it does
Get a gameLook up one game by its IGDB ID, including its rating, genres, platforms, studios, and cover art.
Get top rated gamesList the highest-rated games on IGDB, best first, with a floor on how many players must have rated them.
Get upcoming gamesList games with a confirmed release date still to come, soonest first.
Search gamesSearch IGDB's video game database by title.

Get a game

Look up one game by its IGDB ID, including its rating, genres, platforms, studios, and cover art.

Inputs

Game IDgame_idtextRequired
The game's IGDB ID, as returned by Search games.

Outputs

cover_urltext
Direct link to the cover art, ready to use
critic_ratingnumber
Average critic rating out of 100, when IGDB has one
developerslist
Studios that developed it
game_idnumber
The game's IGDB ID. Use with Get a game.
game_modeslist
How it can be played, for example 'Single player'
genreslist
Genre names, for example 'Role-playing (RPG)'
nametext
The game's title
platformslist
Platforms it released on, for example 'PlayStation 5'
publisherslist
Companies that published it
ratingnumber
Average player rating out of 100
rating_countnumber
How many players have rated it
release_datetext
The first release date as YYYY-MM-DD, or empty if unannounced
slugtext
The URL-safe form of the title, for example 'the-witcher-3'
storylinetext
A longer description of the plot, when IGDB has one
summarytext
A short description of the game
themeslist
Theme names, for example 'Fantasy' or 'Horror'
total_ratingnumber
Player and critic ratings combined, out of 100
urltext
Link to the game's page on IGDB
Example output
{
  "cover_url": "https://images.igdb.com/igdb/image/upload/t_cover_big/co1wyy.jpg",
  "critic_rating": 92.1,
  "developers": [
    "CD PROJEKT RED"
  ],
  "game_id": 1942,
  "game_modes": [
    "Single player"
  ],
  "genres": [
    "Role-playing (RPG)",
    "Adventure"
  ],
  "name": "The Witcher 3: Wild Hunt",
  "platforms": [
    "PC (Microsoft Windows)",
    "PlayStation 4",
    "Xbox One"
  ],
  "publishers": [
    "CD PROJEKT"
  ],
  "rating": 93.4,
  "rating_count": 3421,
  "release_date": "2015-05-19",
  "slug": "the-witcher-3-wild-hunt",
  "storyline": "Geralt of Rivia sets out to find Ciri, the Child of Prophecy.",
  "summary": "A story-driven open world RPG set in a visually stunning fantasy universe, full of meaningful choices and impactful consequences.",
  "themes": [
    "Action",
    "Fantasy",
    "Open world"
  ],
  "total_rating": 92.8,
  "url": "https://www.igdb.com/games/the-witcher-3-wild-hunt"
}

Get top rated games

List the highest-rated games on IGDB, best first, with a floor on how many players must have rated them.

Inputs

Minimum number of ratingsmin_rating_countnumber
Only include games rated by at least this many players. Without a floor the top of the list fills up with obscure games carrying a single perfect score.At least 0. Default: 100.
How many gameslimitnumber
How many games to return (1-500).From 1 to 500. Default: 10.

Outputs

gameslist
The highest-rated games, best first
Example output
{
  "games": [
    {
      "cover_url": "https://images.igdb.com/igdb/image/upload/t_cover_big/co1wyy.jpg",
      "critic_rating": 92.1,
      "developers": [
        "CD PROJEKT RED"
      ],
      "game_id": 1942,
      "game_modes": [
        "Single player"
      ],
      "genres": [
        "Role-playing (RPG)",
        "Adventure"
      ],
      "name": "The Witcher 3: Wild Hunt",
      "platforms": [
        "PC (Microsoft Windows)",
        "PlayStation 4",
        "Xbox One"
      ],
      "publishers": [
        "CD PROJEKT"
      ],
      "rating": 93.4,
      "rating_count": 3421,
      "release_date": "2015-05-19",
      "slug": "the-witcher-3-wild-hunt",
      "storyline": "Geralt of Rivia sets out to find Ciri, the Child of Prophecy.",
      "summary": "A story-driven open world RPG set in a visually stunning fantasy universe, full of meaningful choices and impactful consequences.",
      "themes": [
        "Action",
        "Fantasy",
        "Open world"
      ],
      "total_rating": 92.8,
      "url": "https://www.igdb.com/games/the-witcher-3-wild-hunt"
    }
  ]
}

Get upcoming games

List games with a confirmed release date still to come, soonest first.

Inputs

How many gameslimitnumber
How many games to return (1-500).From 1 to 500. Default: 10.

Outputs

gameslist
Games still to be released, soonest first
Example output
{
  "games": [
    {
      "cover_url": "https://images.igdb.com/igdb/image/upload/t_cover_big/co1wyy.jpg",
      "critic_rating": null,
      "developers": [
        "CD PROJEKT RED"
      ],
      "game_id": 250616,
      "game_modes": [
        "Single player"
      ],
      "genres": [
        "Role-playing (RPG)",
        "Adventure"
      ],
      "name": "The Witcher IV",
      "platforms": [
        "PC (Microsoft Windows)",
        "PlayStation 4",
        "Xbox One"
      ],
      "publishers": [
        "CD PROJEKT"
      ],
      "rating": null,
      "rating_count": null,
      "release_date": "2027-11-12",
      "slug": "the-witcher-iv",
      "storyline": "Geralt of Rivia sets out to find Ciri, the Child of Prophecy.",
      "summary": "A story-driven open world RPG set in a visually stunning fantasy universe, full of meaningful choices and impactful consequences.",
      "themes": [
        "Action",
        "Fantasy",
        "Open world"
      ],
      "total_rating": null,
      "url": "https://www.igdb.com/games/the-witcher-iv"
    }
  ]
}

Search games

Search IGDB's video game database by title. Editions such as 'Collector's Edition' are left out so you get the games themselves.

Inputs

TitlequerytextRequired
The game title to search for, for example 'The Witcher 3'.
How many gameslimitnumber
How many games to return (1-500).From 1 to 500. Default: 10.

Outputs

gameslist
The matching games
Example output
{
  "games": [
    {
      "cover_url": "https://images.igdb.com/igdb/image/upload/t_cover_big/co1wyy.jpg",
      "critic_rating": 92.1,
      "developers": [
        "CD PROJEKT RED"
      ],
      "game_id": 1942,
      "game_modes": [
        "Single player"
      ],
      "genres": [
        "Role-playing (RPG)",
        "Adventure"
      ],
      "name": "The Witcher 3: Wild Hunt",
      "platforms": [
        "PC (Microsoft Windows)",
        "PlayStation 4",
        "Xbox One"
      ],
      "publishers": [
        "CD PROJEKT"
      ],
      "rating": 93.4,
      "rating_count": 3421,
      "release_date": "2015-05-19",
      "slug": "the-witcher-3-wild-hunt",
      "storyline": "Geralt of Rivia sets out to find Ciri, the Child of Prophecy.",
      "summary": "A story-driven open world RPG set in a visually stunning fantasy universe, full of meaningful choices and impactful consequences.",
      "themes": [
        "Action",
        "Fantasy",
        "Open world"
      ],
      "total_rating": 92.8,
      "url": "https://www.igdb.com/games/the-witcher-3-wild-hunt"
    }
  ]
}

iDigBio

Previous Page

iLovePDF

Next Page

On this page

ActionsGet a gameGet top rated gamesGet upcoming gamesSearch games