Organizing all the world's video games is a complicated thing with a lot of fields and things that you can search, but we didn't want a million-bajillion HTML input fields clogging up the UI when in most cases you'll only want to search by a few specific fields. As a solution to this, we've implemented search flags. Oh yes! Oh yes! Add these flags anywhere within your query to make your search as broad or specific as you need it to be!

  • The format of a flag is: flag:parameter(s)
  • If a flag has an alias, you may use the flag's alias in place of the flag. This is good sometimes if the flag name is really long or easy to get confused.
  • For boolean parameter values, use true, 1, on, or yes for true, or anything else for false.
  • For flags that can have multiple parameters, separate each parameter with ,.

Here is a list of all available flags:

Flag [alias] Parameter(s) Example
abbreviation [string]

Search by a specific system. Use the system's VGDB-official abbreviation to designate that system. For a full list of system abbreviations, see systems.

edition [string]

VGDB groups all game releases into 1 of 5 possible categories which we call "editions". Here is a list of the editions that a game can be:

  1. Standard A standard release of a game. The vast majority will be this.
  2. Special A release of a game considered more "special" or with more significant meaning than a standard release. These are typically things like Collector's Edition, Limited Edition, Pay-Extra-To-Get-More-Stuff-In-A-Bigger-Box Edition, and so on.
  3. Budget A release of a game with a budget marketing label of some kind, typically used to sell more copies long after the date of the standard release. These are typically but not always re-releases of a standard release. Well known budget labels include: Nintendo Selects, Greatest Hits, Happy Price Selection, and so on.
  4. Demo A demo of the game.
  5. Diagnostic Software used to help diagnose and test for software and hardware problems. Typically used internally by repair companies and not intended for the public.
region [string]

All games in the entire world must be released in 1 of 6 possible areas of land we call "regions". A region is important enough, from a gaming point of view, to be distinguished into its own category. Regions are basically the same as continents of the world except A) Africa and Antarctica have no releases so we removed them and B) Japan, which geographically is part of Asia, is distinguished enough from the rest of Asia from a gaming point of view, so we place games released there into its own category. Here is a list of all 6 regions:

  1. NA North America
  2. EU Europe
  3. JP Japan
  4. AS Asia
  5. SA South America
  6. AU Australia
owned [boolean]

Search for games that you own or don't own in your collection. A user must be logged in or this flag is ignored.

sort [string]

Search results are organized by the sort field. Possible values are:

  1. title
  2. year
  3. random
[direction [string]]

Sort in ascending or descending order. Possible values are asc (ascending) and desc (descending).

year [string]

The 4-digit year that a game was released.

prefix [string]

String that this game release must have at the beginning of its title.

suffix [string]

String that this game release must have at the end of its title.

unlicensed [boolean]

An unlicensed game is a game that is not sponsored or approved by the console manufacturer, released anyway without their knowledge, consent, or permission.

kiosk [boolean]

A release of a game used specifically inside in-store kiosks for demonstration and promotional purposes, not intended for the public.

longbox [boolean]

Applies to PlayStation only. A game release in a "longbox" style box. Used only at the beginning of PlayStation's existence in 1995-96.