Search:
Game Publisher
Author Machine

getMinReleaseDateItem

Brings back the item that Everygamegoing has in its archives that has the lowest "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 earliest released game we have (at time of writing, Adventureland for the Apple II/Apple II+. However, it can also be used to show the first item released for any machine.

Note: The call takes the same parameters as the call to randomValueItem.

http://www.everygamegoing.com/api/v1/getMinReleaseDateItem/[machine_type_id]/[with_attribute]

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

  1. Cover ... Return only an attribute which has a cover scan
  2. Screenshot ... Return only an attribute which has at least one screenshot
  3. 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:

http://www.everygamegoing.com/api/v1/getMinReleaseDateItem/9999/Cover

and it returns the following response:

{
	"response":
	{
		"item_id":79899,
		"covl":"covl\/apple_ii\/ai_usa\/tapes\/Adventureland_000.jpg",
		"covs":"covs\/apple_ii\/ai_usa\/tapes\/Adventureland_000.jpg",
		"covl_small":"shop\/covl_small\/apple_ii\/ai_usa\/tapes\/Adventureland_000.jpg",
		"covl_tiny":"shop\/covl_tiny\/apple_ii\/ai_usa\/tapes\/Adventureland_000.jpg",
		"ills":
		[
			"ills\/apple_ii\/ai_usa\/tapes\/Adventureland_000.gif",
			"ills\/apple_ii\/ai_usa\/tapes\/Adventureland_001.gif",
			"ills\/apple_ii\/ai_usa\/tapes\/Adventureland_002.gif"
		],
		"show_title":"Adventureland",
		"publisher_info":"Adventure International USA",
		"machine_type_group_name":"Apple II\/II+",
		"format_type_info":"Cassette",
		"landing_page_link":"landing\/items\/apple_ii\/ai_usa\/tapes\/Adventureland.html",
		"release_date":"1977-12-03 00:00:00",
		"formatted_release_date":"3rd December 1977"
	}
}

 
The following table shows the data types returned:

Key Human-readable Explanation Value Data Type Value Example
item_id Item ID Integer 79889
covl Cover Art (Largest) String covl/...
covs Cover Art (Regular Size) String covs/...
covl_small Cover Art (Shop Size) String shop/covl_small/...
covl_tiny Cover Art (Shop Smallest) String covl_tiny/...
ills Screenshots Array Key->String
show_title Show Title String Adventureland
publisher_info Publisher String Adventure International USA
machine_type_group_name Stated Machine Compatibility String Apple II/II+
format_type_info Media Format Of Item String Cassette
release_date Release Date (DB Format) String 1977-12-03 00:00:00
formatted_release_date Release Date (UK Format) String 3rd December 1977

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.