Brings back an array containing every item on the Everygamegoing site that is compatible with the [machine_type_id] specified.
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/[machine_type_id]/[library_name/[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]:
will return a response similar to the following:
{
"response":
[
{
"item_id":"74962",
"show_title":".hack\/\/Infection"
},
{
"item_id":"74963",
"show_title":".hack\/\/Mutation"
},
{
"item_id":"74964",
"show_title":".hack\/\/Outbreak"
},
...
{
"item_id":"76300",
"show_title":"Zapper: One Wicked Cricket"
},
{
"item_id":"76301",
"show_title":"Zombie Hunters"
},
{
"item_id":"76302",
"show_title":"Zombie Hunters 2 (UK Version)"
},
{
"item_id":"75609",
"show_title":"Zoocube"
}
]
}
Key
| Human-readable Explanation
| Value Data Type
| Value Example
|
item_id |
Item ID |
Integer |
74962 |
show_title |
Show Title |
String |
.hack\/\/Infection |
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:
-
Prof
Items for the target [machine_type_id], excluding Adult titles, that were professionally published (i.e. sold for cash).
-
Public Domain
Items for the target [machine_type_id], excluding Adult titles, that feature "Public Domain" games (i.e. given away for free).
-
Companion
Items for the target [machine_type_id] that originally came with a companion magazine (i.e. cover discs).
-
Adult
Items for the target [machine_type_id], both professional and Public Domain, that are sexually explicit in nature.
-
Machine Expansion
Items for the target [machine_type_id] that are physical hardware expansions.
-
Books
Books for the target [machine_type_id].
-
Unreleased; Recovered
Items for the target [machine_type_id] that were not released but have been recovered (although not necessarily in a complete form).
-
Emulator
Items for the target [machine_type_id] that emulate a different machine.
-
Mag
Issues of magazines for the target [machine_type_id].
-
Unfinished
Items for the target [machine_type_id] that were known to have been started but not finished.
-
Unreleased
Items for the target [machine_type_id] that were known to have been completed but not released.
-
Video
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
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/1/library_name/Prof/
-
Get all Item IDs of public domain releases for the BBC Micro
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/2/library_name/Public Domain/
-
Get all Item IDs of companion tapes and discs for the Acorn Electron
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/7/library_name/Companion/
-
Get all Item IDs of adult games for the Acorn Electron
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/7/library_name/Adult/
-
Get all Item IDs of expansions for the Acorn Electron
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/7/library_name/Machine Expansion/
-
Get all Item IDs of books for the Spectrum 16K
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/31/library_name/Books/
-
Get all Item IDs of unreleased but recovered games for the Commodore 64
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/15/library_name/Unreleased; Recovered/
-
Get all Item IDs of emulators for the PC
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/347/library_name/Emulator/
-
Get all Item IDs of magazines for the Amstrad CPC 464
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/8/library_name/Mag/
-
Get all Item IDs of unfinished games for the BBC Master 128
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/5/library_name/Unfinished; Recovered/
-
Get all Item IDs of unreleased games for the Dragon
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/1/library_name/Unreleased; Not Recovered/
-
Get all Item IDs of videos featuring the Acorn Electron
https://www.everygamegoing.com/api/getAllItemIDs/index/machine_type_id/7/library_name/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.