Shows top X list of firstnames in the specified place and year. When a person has multiple fornames, only the first is counted.
https://api.openarchieven.nl/1.0/stats/firstnames.json
GET
| Name | Required | Description | Default |
|---|---|---|---|
| eventplace | Yes | Existing place name. Currenlty, only Amsterdam is available | Amsterdam |
| eventyear | Yes | The year of events to include in selection (minimum=1600, maximum=1960). | |
| number_show | No | Maximum number (the 'X') of results (maximum=50). | 10 |
| callback | No | Function name to be called on JSON data (JSONP). |
Example: https://api.openarchieven.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
}
}
}
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 |
| 43 | Value of eventyear is below defined minimum (1600) or above defined maximum (1960) |
| 44 | Missing eventyear |
| 45 | Missing eventplace |
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/