Search:
Game Publisher
Author Machine

Brings back an array of all the publishers on the Everygamegoing site which match the filters specified.

The filters can be one of two different types - either machine_type_id or machine_type_group_id.

Each bring back responses in the same format but have the potential to confuse you if you do not use them correctly, so take care...


getAllPublishers/machine_type_id/

Brings back an array of all the publishers on the Everygamegoing site which match the Machine Type ID specified.

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

The [machine_type_id] parameter is mandatory and must be specified correctly for this call to work.

The following call, substituting '7' for [machine_type_id]:

http://www.everygamegoing.com/api/v1/getAllPublishers/machine_type_id/7/

will return a response similar to the following:

{
	"response":
	[
		{
			"count":346,
			"publishers":
			{
				"1":"A 'n F",
				"283":"A&B Computing",
				...
				"517":"Your Computer",
				"256":"Zomba"
			}
		}
	]
}

 
The fields returned are all self-explanatory but a table explaining them is given below.

Key Human-readable Explanation Value Data Type Value Example
count Count Integer 346
publishers Publishers Array  
Key Human-readable Explanation Value Data Type Value Example
[publisher_id] Publisher ID String 1
[publisher_name] Publisher Name String A 'n F

What this command is effectively doing is bringing you a list of all of the publishers for a particular machine. The above example retrieves all of the publishers who published games for the Acorn Electron, which has the Machine Type ID 7.

You cannot get all publishers without narrowing them down to a particular machine in this sort of way (The array would simply be too long).

To use this command effectively, you need to know the Machine Type ID of interest. You can use the command getAllMachines to retrieve an array which includes that information.


getAllPublishers/machine_type_group_id/

Brings back an array of all the publishers on the Everygamegoing site which match the Machine Type Group IDs specified.

http://www.everygamegoing.com/api/v1/getAllPublishers/machine_type_group_id/[machine_type_group_id(s)]

The [machine_type_group_id(s)] parameter is mandatory and must be specified correctly for this call to work.

The following call, substituting '8' for [machine_type_group_id(s)]:

http://www.everygamegoing.com/api/v1/getAllPublishers/machine_type_group_id/8/

will return a response similar to the following:

{
	"response":
	[
		{
			"count":651,
			"publishers":
			{
				5916:"21st Century",
				1009:"39 Steps",
				...
				2584:"Zigurat",
				8981:"Zrilon"
			}
		}
	]
}

 
The fields returned are all self-explanatory but a table explaining them is given below.

Key Human-readable Explanation Value Data Type Value Example
count Count Integer 651
publishers Publishers Array  
Key Human-readable Explanation Value Data Type Value Example
[publisher_id] Publisher ID String 5916
[publisher_name] Publisher Name String 21st Century

What this command is effectively doing is bringing you a list of all of the publishers for a particular machine. The above example retrieves all of the publishers who published games for the Amstrad CPC, which has the Machine Type Group ID 8.

You cannot get all publishers without narrowing them down to a particular machine in this sort of way (The array would simply be too long).

You can get the publishers for up to six Machine Type Groups at the same time, by specifying a parameter for [machine_type_group_id(s)] with the IDs divided by the | (pipe) symbol. And, to ensure you are getting all publishers, you will frequently need more than one Machine Type Group ID.

For example, Machine Type Group ID 7 is the Acorn Electron, so:

http://www.everygamegoing.com/api/v1/getAllPublishers/machine_type_group_id/7

will return you the publishers of every item that was denoted "Acorn Electron". However, many items were published denoted "BBC/Electron". The Machine Type Group ID for "BBC/Electron" is 327, so:

http://www.everygamegoing.com/api/v1/getAllPublishers/machine_type_group_id/327

will return you the publishers of every item that was denoted "BBC/Electron". But there are yet further groups: "BBC Master Compact/Electron" (355) and "Spectrum 16K/48K/BBC A/BBC B/Electron" (397).

So, to get every publisher that ever published anything that included an Electron version, you would use:

http://www.everygamegoing.com/api/v1/getAllPublishers/machine_type_group_id/7|327|355|397

This makes this command a little more difficult to use than normal, as to use it effectively, you need to know the machine_type_group_id(s) of interest. Please see the command getMachineTypeGroupIDsByMachineType for more information.