Open Archives API » Stats/FirstNames

Shows top X list of firstnames in the specified place and year. When a person has multiple fornames, only the first is counted.

URL

https://api.openarch.nl/1.0/stats/firstnames.json

Method

GET

Input

NameRequiredDescriptionDefault
eventplaceYesExisting place name. Currenlty, only Amsterdam is availableAmsterdam
eventyearYesThe year of events to include in selection (minimum=1600, maximum=1960).
number_showNoMaximum number (the 'X') of results (maximum=50).10
callbackNoFunction name to be called on JSON data (JSONP).

Output

Example: https://api.openarch.nl/1.0/stats/firstnames.json?eventplace=Amsterdam&eventyear=1720 outputs (pretty-printed):

{
	request: {
		eventplace: "Amsterdam",
		eventyear: 1720,
		number_show: 10
	},
	response: {
		firstnames: {
			Anna: 248,
			Jan: 232,
			Maria: 229,
			Johannes: 187,
			Pieter: 147,
			Johanna: 135,
			Catharina: 114,
			Joannes: 109,
			Jacob: 88,
			Jacobus: 81
		}
	}
}

Errors

One of the following errors may be thrown:

Error codeError message
4Invalid lang
10Invalid number_show
23Value of number_show exceeds defined maximum
43Value of eventyear is below defined minimum (1600) or above defined maximum (1960)
44Missing eventyear
45Missing eventplace

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 Genealogie Online via https://www.genealogieonline.nl/en/