Open Archives API » Stats/FamilyNames

Shows the number of times family names appear in events in the selected source types, place and period.

URL

https://api.openarch.nl/1.0/stats/familynames.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
eventtype	No	Numeric value of depiciting the event type: 0 - All types 1 - Christening and birth records 2 - Marriage records 3 - Burial and death records 6 - Notarial deeds	0
number_show	No	Maximum number of results (maximum=100).	50
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 family name frequency.

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

{
	"cols": [
		{
			"id": "",
			"label": "Familienaam",
			"type": "string"
		},
		{
			"id": "",
			"label": "Aantal persoonsvermeldingen",
			"type": "number"
		}
	],
	"rows": [
		{
			"c": [
				{
					"v": "Van Leeuwen"
				},
				{
					"v": 21700
				}
			]
		},
		{
			"c": [
				{
					"v": "Van den Berg"
				},
				{
					"v": 14060
				}
			]
		},
		{
			"c": [
				{
					"v": "Smit"
				},
				{
					"v": 10229
				}
			]
		},
.....		
	}
]

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
28	Invalid eventype

An example error looks (pretty-printed) like:

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

Back to API documentation