Search Flags

You can use search flags to make your search even more powerful and as specific as you need it to be! Just add the flag anywhere as part of your search.

  • Flag format: flag:parameter. For flags that have multiple parameters, separate each parameter with , (a comma).
  • If a flag has an alias, you can use the alias if you want for your convenience.
  • For boolean parameter types, use true, 1, on, or yes for true, or anything else for false.
  • Let us know any other flags you'd like to see.
Flag (alias) Parameter(s) Example Usage
blackbox [boolean]

Whether or not the release is considered a "black box" release for NES. A "black box" release is one of the earliest NES games published by Nintendo with a black boxart style and design. Set this to true to show black box releases.

budget [boolean]

Whether or not this release is a "budget" release, e.g. "Player's Choice", "Greatest Hits", "Sega All-Stars", etc.

This flag is functionally equivalent to release_type:Budget.

groupbygame [boolean]

Whether or not to group search results by game. If true, we will group matched releases so that at most one shows per unique game. If false, all matched releases will be shown regardless of game. Defaults to: true.

in_collection (owned)
in_collection [boolean]

Whether you own this release in your collection or not. Great for building collections, finishing sets, and creating checklists! If no user is logged in, this flag is ignored.

kiosk [boolean]

Whether or not this release was originally used inside a store kiosk for demonstration/promotional purposes. kiosk releases are a subset of "Demo" releases releases (every kiosk release is a demo, but not every demo is a kiosk release).

licensed (lic)
licensed [boolean]

Whether or not the release is licensed (sponsored/approved/permitted by the console manufacturer).

longbox [boolean]

Whether or not this release is a "longbox" release. A "longbox" release is one of the earliest released (1995-1996) games for PlayStation with a longer box, hence the name. Although games for Sega Saturn and Sega CD often use the same boxes, we only consider "longbox" games to be for original PlayStation since that's the only system where the distinction has any meaning.

major_boxart_update [boolean]

Whether or not the release is has a major boxart update from a different release of the same game from the same region of the same type. Set this to true to show releases with major boxart updates.

order [string]

How to order search results by. Valid ways to order are:

  1. title Order by title of the release
  2. year Order by year released.
  3. created_at Order by the time the release was added to VGDB.
  4. updated_at Order by the time the release was most recently updated in VGDB.
  5. random In random order!
[direction [string]]

Direction to order search results. Use asc for ascending order, or desc for descending order. Defaults to asc.

prefix (startswith)
prefix [string]

A prefix string that the title of this release must start with.

region (reg)
region [string]

The region that this release was officially distributed/released in. We group all releases around the world as being in the following 6 regions. 99+% of the time a release will have only one region, but they can be released for multiple regions (with NO provable differences in packaging or content). Pass the 2 digit region code to only show releases for that region. The list of valid regions are:

  1. NA North America
  2. EU Europe
  3. JP Japan
  4. AS Asia (Excluding Japan)
  5. SA South America
  6. AU Australia
release_type (type)
release_type [string]

The "type" of this release. We group all releases into six distinct types. Pass the type as the value of the parameter to get releases of only that type. These types are:

  1. Standard A standard release of a game.
  2. Special A release of a game with some degree of elevated or special significance (e.g. Collector's Edition, Limited Edition).
  3. Budget A release of a game with some sort of marketing label used by the publisher to distinguish it as such, typically created to help sell more copies long after initial release and at a lower price point (e.g. Nintendo Selects, Greatest Hits, Happy Price Selection).
  4. Demo A release created specifically for demonstration and/or promotional purposes. Sometimes, demo releases are created for public distribution, but other times, they are created for some sort of internal use only (such as at the publisher, distributor and/or retailer levels).
  5. Unofficial An unofficial release, similar to a bootleg but generally of much higher quality, and by an organization with some degree of commercial viability.
  6. Other A release that does not fit into the other categories goes here.
suffix (endswith)
suffix [string]

A suffix string that the title of this release must end with.

system (sys)
abbreviation [string]

The system that this release is for. We denote each system in our database with a unique 2-4 character "abbreviation". Put the system abbreviation as the value to specify the release must be for that system. For a list of all system abbreviations, see systems page.

territory [string]

The territory that the release was released for. Territories are a 3 digit code for NINTENDO GAMES ONLY which they used to organize their distribution practices. Territories can be areas of land more specific than the 6 regions. Pass the 3 digit territory code to show only releases for that territory. For more informaton including a list of valid territories you can pass, see territories page.

unlicensed (unl)
unlicensed [boolean]

Whether or not the release is unlicensed (not sponsored, approved, permitted, endorsed, and/or allowed by the console manufacturer).

This flag is functionally equivalent to licensed:yes except using the opposite boolean value.

updated_publisher [boolean]

Whether or not the publisher of this release has been updated from a previous release of the same game. In some (rare) cases, a different publisher (company) can release a game that is different from a publisher that released it previously in the same region.

year [string]

The 4-digit year that this release was released, e.g. 1984.