Shows the number of times family names appear in events in the selected source types, place and period.
https://api.openarch.nl/1.0/stats/familynames.json
GET
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 |
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). |
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 } ] }, ..... } ]
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" }
Find your ancestors and publish your family tree on Genealogy Online via https://www.genealogieonline.nl/en/