Search:
Game Publisher
Author Machine

Brings back an array of all the items that were released during the year (YYYY) and month (MM) given by the call. The call is in the following format:

http://www.everygamegoing.com/api/v1/getItemsReleasedByYearAndMonth/[year]/[month_number]

Both [year] and [month_number] are mandatory parameters and no results will be returned without both of them being specified correctly.

The following call, substituting '1986' for [year] and '12' for [month_number]:

http://www.everygamegoing.com/api/v1/getItemsReleasedByYearAndMonth/1986/12/

will return a response containing all the items in the Everygamegoing database that were released in December (12th month) of 1986 (year). (Note that responses can be quite large!):

{
	"response":
	{
		"count":78,
		"items":
		{
			"Dragon 32":
			{
				"Cassette":
				{
					"11990":
					{
						"item_id":11990,
						"release_date":"1986-12-01 00:00:00",
						"flag_release_date_exact":"0",
						"show_title":"Decathlon",
						"publisher_id":111,
						"publisher_info":"Maridian",
						"format_type_group_id":1001,
						"format_type_group_name":"Cassette",
						"machine_type_group_id":1
						"machine_type_group_name":"Dragon 32",
					},
					...
				}
			}
			...
			"Nintendo (US Version)":
			{
				"ROM Cart":
				{
					"64608":
					{
						"item_id":64608,
						"release_date":"1986-12-01 00:00:00",
						"flag_release_date_exact":0,
						"show_title":"Gradius",
						"publisher_id":1738,
						"publisher_info":"Konami",
						"format_type_group_id":1005,
						"format_type_group_name":"ROM Cart",
						"machine_type_group_id":359,
						"machine_type_group_name":"Nintendo (US Version)"
					}
				}
			}
		}
	}
}

 
Although the call itself is simple, the response that is returned is a multi-dimensional array. At its top-level, it contains two keys:

Key Human-readable Explanation Value Data Type Value Example
count Count Of Items Integer 78
items Items Array  

items is a further array which contains the keys corresponding to the names of the machine type groups for which items were released. Each of these, in turn, holds a further key describing the format upon which items were released, and inside that the item_id as the key for the final the key-value pairs, which are as follows:

Key Human-readable Explanation Value Data Type Value Example
item_id Item ID Integer 11991
release_date Release Date String 1986-12-01
flag_release_date_exact Flag Release Date Exact Integer 0
show_title Dragon Music String E
publisher_id Publisher ID Integer 111
publisher_info Publisher Info String Maridian
format_type_group_id Format Type Group ID Integer 1001
format_type_group_name Format Type Group Name String Dragon 32