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

NameRequiredDescriptionDefault
eventplaceNoExisting place name.
eventyearstartNoThe starting year of events to include in selection (minimum=1500).1500
eventyearendNoThe ending year of events to include in selection (maximum=1960).1960
number_showNoMaximum number of results (maximum=100).75
langNoLanguage code (nl for Dutch, en for English, de for Germand, fr for French) to be used for data labels.nl
callbackNoFunction 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 codeError message
4Invalid lang
10Invalid number_show
23Value of number_show exceeds defined maximum
24Value of eventyearstart exceeds defined maximum
25Value of eventyearstart is below defined minimum
26Value of eventyearend exceeds defined maximum
27Value of eventyearend is below defined minimum

An example error looks (pretty-printed) like:

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

Back to API documentation

Find your ancestors and publish your family tree on Genealogy Online via https://www.genealogieonline.nl/en/