Brings back the item that Everygamegoing has in its archives that has the highest "official" release date, excluding those items where we have no idea what the release date was.
This call is used on the home page of the site to show the very latest released game we have in the database (at time of writing, Fateextella The Umbral Star for the PlayStation Vita. However, it can also be used to show the most recently released item for any machine.
Note: The call takes the same parameters as the call to randomValueItem.
[machine_type_id] is a mandatory parameter, and allows you to filter a random item for a particular machine. You can discover the machine_type_id for any machine by using the call to getAllMachines. If you do not want to filter then place 9999 as the value for this parameter.
[with_attribute] is an optional parameter and using it simply allows you to force the return of an item with a particular attribute. The accepted values for [with_attribute] are:
Cover ... Return only an attribute which has a cover scan
Screenshot ... Return only an attribute which has at least one screenshot
None ... Return any item regardless of whether it has a cover scan or screenshot
Specifying "None" will return the same result as not specifying a value for the [with_attribute].
For example, the following call is used on the home page to show the earliest release we have on the site:
and it returns the following response:
"show_title":"Fateextella The Umbral Star",
"format_type_info":"PlayStation Vita Card",
"formatted_release_date":"10th January 2017"
The following table shows the data types returned:
||Value Data Type
||Cover Art (Largest)
||Cover Art (Regular Size)
||Cover Art (Shop Size)
||Cover Art (Shop Smallest)
||Stated Machine Compatibility
||Media Format Of Item
||PlayStation Vita Card
||Release Date (DB Format)
||Release Date (UK Format)
||10th January 2017
Note: The ills array will only be returned if the database features screenshots of the game in action. Make sure you test to ensure it exists before parsing it.
Note that there is also a call which returns information on the most recently released item called getMostRecentlyReleasedItem. You should examine the differences between the two and choose the one which is the more suitable for your application.