Brings back an array containing every item on the Everygamegoing site that is compatible with the [machine_type_id] specified.

http://www.everygamegoing.com/api/v1/getAllItemIDs/[machine_type_id]/[library_name]

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]:

http://www.everygamegoing.com/api/v1/getAllItemIDs/338/

will return a response similar to the following:

{
	"response":
	{

		".hack\/\/Infection":74962,
		".hack\/\/Mutation":74963,
		".hack\/\/Outbreak":74964,
		".hack\/\/Quarantine: The Final Chapter":74965,
		"007: Agent Under Fire":74960,
		...
		"Zombie Hunters 2 (UK Version)":76302,
		"Zombie Virus":76303,
		"Zombie Zone (UK Version)":76304,
		"Zone Of The Enders":76305,
		"Zone Of The Enders: The 2nd Runner":76306,
		"Zoo Puzzle":52347,
		"Zoocube":75609
	}
}

Key Human-readable Explanation Value Data Type Value Example
machine_type_id Show Title String .hack\/\/Infection
item_id Item ID Integer 74962

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:

  1. Prof
    Items for the target [machine_type_id], excluding Adult titles, that were professionally published (i.e. sold for cash).
  2. Pd
    Items for the target [machine_type_id], excluding Adult titles, that feature "Public Domain" games (i.e. given away for free).
  3. Companion
    Items for the target [machine_type_id] that originally came with a companion magazine (i.e. cover discs).
  4. Adult
    Items for the target [machine_type_id], both professional and Public Domain, that are sexually explicit in nature.
  5. Expansion
    Items for the target [machine_type_id] that are physical hardware expansions.
  6. Book
    Books for the target [machine_type_id].
  7. Unreleased; Recovered
    Items for the target [machine_type_id] that were not released but have been recovered (although not necessarily in a complete form).
  8. Emulator
    Items for the target [machine_type_id] that emulate a different machine.
  9. Mag
    Issues of magazines for the target [machine_type_id].
  10. Unfinished
    Items for the target [machine_type_id] that were known to have been started but not finished.
  11. Unreleased
    Items for the target [machine_type_id] that were known to have been completed but not released.
  12. Video
    Films/movies/documentaries that feature the target [machine_type_id].

The calls using the [library_name] parameter are best illustrated by examples.

  1. Get all Item IDs of professional releases for the Dragon 32
    http://www.everygamegoing.com/api/v1/getAllItemIDs/1/Prof
  2. Get all Item IDs of public domain releases for the BBC Micro
    http://www.everygamegoing.com/api/v1/getAllItemIDs/2/Pd
  3. Get all Item IDs of companion tapes and discs for the Acorn Electron
    http://www.everygamegoing.com/api/v1/getAllItemIDs/7/Companion
  4. Get all Item IDs of adult games for the Acorn Electron
    http://www.everygamegoing.com/api/v1/getAllItemIDs/7/Adult
  5. Get all Item IDs of expansions for the Acorn Electron
    http://www.everygamegoing.com/api/v1/getAllItemIDs/7/Expansion
  6. Get all Item IDs of books for the Spectrum 16K
    http://www.everygamegoing.com/api/v1/getAllItemIDs/31/Book
  7. Get all Item IDs of unreleased but recovered games for the Commodore 64
    http://www.everygamegoing.com/api/v1/getAllItemIDs/15/Unreleased;%20Recovered
  8. Get all Item IDs of emulators for the PC
    http://www.everygamegoing.com/api/v1/getAllItemIDs/347/Emulator
  9. Get all Item IDs of magazines for the Amstrad CPC 464
    http://www.everygamegoing.com/api/v1/getAllItemIDs/8/Mag
  10. Get all Item IDs of unfinished games for the BBC Master 128
    http://www.everygamegoing.com/api/v1/getAllItemIDs/5/Unfinished
  11. Get all Item IDs of unreleased games for the Dragon
    http://www.everygamegoing.com/api/v1/getAllItemIDs/1/Unreleased
  12. Get all Item IDs of videos featuring the Acorn Electron
    http://www.everygamegoing.com/api/v1/getAllItemIDs/7/Video

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.