Brings back an array containing every item on the Everygamegoing site that is compatible with the [machine_type_id] specified.
Note: The [machine_type_id] is mandatory. Refer to getAllMachines for further details.
Note: The [library_name] is optional and is discussed further below.
Note: There are many thousands of games for some machines (for example, Spectrum 48K). Use this call with caution. Make your call to this once, store the data and then parse it locally for items that may be of interest. Never build an application that calls this frequently.
The following call, substituting 338 (PlayStation 2 (EU Version) for the [machine_type_id]:
will return a response similar to the following:
".hack\/\/Quarantine: The Final Chapter":74965,
"007: Agent Under Fire":74960,
"Zombie Hunters 2 (UK Version)":76302,
"Zombie Zone (UK Version)":76304,
"Zone Of The Enders":76305,
"Zone Of The Enders: The 2nd Runner":76306,
||Value Data Type
Your application should find it easy to get any interesting Item IDs from the associative array in the response.
Whilst the above should satisfy most needs, there is an additional, optional parameter called [library_name]. This is a filter and including it will narrow down the subset of data which the call returns. This [library_name] is a string and must take one of the following values, which are listed below in order of importance:
Items for the target [machine_type_id], excluding Adult titles, that were professionally published (i.e. sold for cash).
Items for the target [machine_type_id], excluding Adult titles, that feature "Public Domain" games (i.e. given away for free).
Items for the target [machine_type_id] that originally came with a companion magazine (i.e. cover discs).
Items for the target [machine_type_id], both professional and Public Domain, that are sexually explicit in nature.
Items for the target [machine_type_id] that are physical hardware expansions.
Books for the target [machine_type_id].
Items for the target [machine_type_id] that were not released but have been recovered (although not necessarily in a complete form).
Items for the target [machine_type_id] that emulate a different machine.
Issues of magazines for the target [machine_type_id].
Items for the target [machine_type_id] that were known to have been started but not finished.
Items for the target [machine_type_id] that were known to have been completed but not released.
Films/movies/documentaries that feature the target [machine_type_id].
The calls using the [library_name] parameter are best illustrated by examples.
Get all Item IDs of professional releases for the Dragon 32
Get all Item IDs of public domain releases for the BBC Micro
Get all Item IDs of companion tapes and discs for the Acorn Electron
Get all Item IDs of adult games for the Acorn Electron
Get all Item IDs of expansions for the Acorn Electron
Get all Item IDs of books for the Spectrum 16K
Get all Item IDs of unreleased but recovered games for the Commodore 64
Get all Item IDs of emulators for the PC
Get all Item IDs of magazines for the Amstrad CPC 464
Get all Item IDs of unfinished games for the BBC Master 128
Get all Item IDs of unreleased games for the Dragon
Get all Item IDs of videos featuring the Acorn Electron
Whether you apply the additional [library_name] filter is entirely up to you. Whether you use the optional parameter or not, note that this command is not intended to be regularly called.
The Item IDs can of course be used with the call to getItemByItemID to return much fuller information about any item.