Open Archives API » Stats/Professions

Shows the number of times professions appear in the selected period and place.

URL

https://api.openarchieven.nl/1.0/stats/professions.json

Method

GET

Input

Name	Required	Description	Default
eventplace	No	Existing place name.
eventyearstart	No	The starting year of events to include in selection (minimum=1500).	1500
eventyearend	No	The ending year of events to include in selection (maximum=1960).	1960
number_show	No	Maximum number of results (maximum=100).	75
lang	No	Language code (nl for Dutch, en for English, de for Germand, fr for French) to be used for data labels.	nl
callback	No	Function name to be called on JSON data (JSONP).

Output

The output is table data in ordered on frequency. Open Archives uses this API to visualize the profession frequency.

Example: https://api.openarchieven.nl/1.0/stats/professions.json outputs (pretty-printed):

{
	"cols": [
		{
			"id": "",
			"label": "Profession",
			"type": "string"
		},
		{
			"id": "",
			"label": "Number of individual entries",
			"type": "number"
		}
	],
	"rows": [
		{
			"c": [
				{
					"v": "zonder beroep"
				},
				{
					"v": 16193
				}
			]
		},
		{
			"c": [
				{
					"v": "arbeider"
				},
				{
					"v": 2239
				}
			]
		},
		{
			"c": [
				{
					"v": "dienstbode"
				},
				{
					"v": 982
				}
			]
		},
......		
	}
]

Errors

One of the following errors may be thrown:

Error code	Error message
4	Invalid lang
10	Invalid number_show
23	Value of number_show exceeds defined maximum
24	Value of eventyearstart exceeds defined maximum
25	Value of eventyearstart is below defined minimum
26	Value of eventyearend exceeds defined maximum
27	Value of eventyearend is below defined minimum

An example error looks (pretty-printed) like:

{
	"error_code": 1,
	"error_description": "Invalid archive"
}

Back to API documentation