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.

  • The format of a flag is flag:parameter - include this anywhere as part of your search query.
  • For flags that have multiple input parameters, separate each input parameter with a comma.
  • If a flag has an alias, you may use the alias if you'd prefer for your convenience.
  • For boolean parameter types, use true, 1, on, or yes for true, or anything else for false.

We can add flags for anything as long as that data is stored in our database somehow, so let us know any other flags you'd like to see that would be helpful for you.

Flag [alias] Parameter(s) Example Usage
blackbox
is_blackbox [boolean]
A "blackbox" release is a release from the original 31 first-party published games for Nintendo NES, released 1985-86.
budget
is_budget [boolean]
Whether or not this is a Budget release type. Releases are considered to be of "Budget" type when they have a distinguishing marketing label added by the publisher (typically designed to be sold long after the initial release and at a lower price point), e.g. "Player's Choice", "Sega All-Stars".
This flag is functionally equivalent to type:Budget.
game_released_in_na
was_released [boolean]
The game associated with the release has at least one North American release.
The 6 game_released_in_XX flags check release existence on the game, so functionality is different than region which checks the release. Great for identifying region exclusive games.
game_released_in_eu
was_released [boolean]
The game associated with the release has at least one European release.
game_released_in_jp
was_released [boolean]
The game associated with the release has at least one Japanese release.
game_released_in_as
was_released [boolean]
The game associated with the release has at least one Asian release.
game_released_in_sa
was_released [boolean]
The game associated with the release has at least one South American release.
game_released_in_au
was_released [boolean]
The game associated with the release has at least one Australian release.
groupbygame
groupbygame [boolean]
If true, the matched releases from your search will be grouped so that at most a single release is shown per game.
kiosk
is_kiosk [boolean]
Kiosk releases were originally used for promotional/demo purposes inside store kiosks to help promote the game before and during its launch. They have some sort of markings on them that distinguish them from the main commercial release. They were not intended to be in the knowledge of the public.
licensed [lic]
is_licensed [boolean]
A licensed release is approved/accepted by the company of the system that the release plays on. Physical manufacturing of each unit is typically (but not always) done by the system's company, with the publisher paying some sort of fee or royalties to them for each unit produced.
This flag is the mutual-inverse of unlicensed.
longbox
is_longbox [boolean]
A "longbox" release is a release produced at the beginning of PlayStation's life (1995-96) with a taller style box. Longbox releases can be the same jewel case plastic material as regular jewel cases, or different material/design (there's a few different styles).
order
order_by [string]
Field used to order search results by. Valid fields are:
  • title Matched releases are ordered by the title (alphabetically)
  • year Matched releases are ordered by the year
  • random Matched releases in random order
[direction [string] = asc]
Direction to order matched releases by. Must be asc (default) for ascending order or desc for descending (reverse) order.
owned
is_owned [boolean]
Whether you have the release marked as "owned" in your collection or not. Great for collectors and finishing sets.
prefix
prefix_string [string]
A string to be used as the prefix that the release's title must match.
publisher_swap
publisher_swap [boolean]
When the publisher of a release sells/transfers their rights to release the game in a given region, to a new publisher that acquires the rights, and re-publishes the release again in the same region, we call this a Publisher Swap. Publisher Swaps are a seldom occurrence and have markings distinguishing it as such - the packaging (game, box, and manual) is typically updated to reflect the new publisher's company logos and information, with no other changes are made (not even the in-game ROM which in most cases show the original publisher's logos and information, and are bit-identical).
region [reg]
region [string]
The broad region of the world that the release was designed for officially distributed within, with markings to indiciate it as such. This is a VGDB region organization system, not an official system used by any system companies.
  • NA North America (including Mexico)
  • EU Europe (including Middle East)
  • JP Japan
  • AS Asia (excluding Japan)
  • SA South America
  • AU Australia
For regions of land more specific than these broad regions, see territories.
has_alternate_boxarts
has_alternate_boxarts [boolean]
Alternative boxarts releases are releases that have a boxart redesign, or multiple boxart versions were made for it. These are for major boxart changes only for releases within the same region, not miniscule differences.
suffix
suffix_string [string]
A string to be used as the prefix that the release's title must match.
system [sys]
abbreviation [string]
The system that this release plays on. Use the abbreviation of the system as the parameter, which is a 2-4 character string that identifies that system. The full list of all systems we currently cover and their abbreviations is on the systems page.
territory
territory_code [string]
The territory of land that the release was created, designed, and officially distributed for, with markings on it distinguishing it as such. Territories are areas of land more specific than the broad regions. Each territory is represented with a 3-character string, used as part of a method of organization officially by Nintendo as part of the release's product code. As such, these territories apply to releases for Nintendo systems only. Releases for other systems such as Sega, PlayStation, Xbox, don't support this.
For a full list of territories, see territories page.
type
type [string]

The type of the 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:

  • Standard The standard main release
  • Special A release with some sort of special or elevated purpose or significance that sets it apart from the standard release (e.g. Collector's Edition)
  • Budget A release with some sort of budget marketing label added by the publisher (e.g. Nintendo Selects)
  • Demo A release that is created or designed for demo or promotional purposes
  • Unofficial An unofficial release, meaning basically a glorified bootleg but made with quality and care by some company that stands behind it, with some sort of commercial viability and print run. Typically some sort of copyright is violated for it to exist. These are different from unlicensed releases (don't get them confused).
  • Other The release does not fall into the other release types
unlicensed [unl]
is_unlicensed [boolean]
An unlicensed release is not sponsored or approved by the company that maintains the system that the release plays on. The publisher of an unlicensed release is typically required to defeat some sort of anti-copying or protection measures built into the system for it to play. The motivation of an unlicensed release is typically for the publisher to avoid paying some sort of fees/royalties to the company that maintains the system, or to create new games after a system's life by hobbyists.
This flag is the mutual-inverse of licensed.
year
year [string]
Year (4 digit format) that the release was debuted to the world.