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

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
eventtypeNoNumeric 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_showNoMaximum number of results (maximum=100).50
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 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 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
28Invalid eventype

An example error looks (pretty-printed) like:

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

Back to API documentation

Publiceer uw stamboom en zoek uw voorouders op Genealogie Online!
https://www.genealogieonline.nl/