---
title: "Family name frequency statistics"
method: GET
path: "/stats/familynames.json"
tags: ["Stats"]
---

# Family name frequency statistics

`GET /stats/familynames.json`

## Request

- Base URL: `https://api.openarchieven.nl/1.1`
- URL: `https://api.openarchieven.nl/1.1/stats/familynames.json`
- Auth: none declared

Returns the number of times family names appear in events for the selected source types, place and period. Results are ordered by frequency. Open Archives uses this endpoint to power its family name frequency visualisation.

## Query parameters

- `eventplace` string
- `eventyearstart` integer
- `eventyearend` integer
- `eventtype` 0 | 1 | 2 | 3 | 6
- `number_show` integer
- `lang` 'nl' | 'en' | 'de' | 'fr'
- `callback` string

## Response `200`

Google DataTable-style response with family name frequency data

- DataTableResponse: Google DataTable-compatible response format used by the FamilyNames and Professions endpoints.
  - `cols` object[]
    - `id` string
    - `label` string
    - `type` 'string' | 'number'
  - `rows` object[]
    - `c` object[]
      - `v` union
        - string
        - number

## Other responses

- `400`: Invalid parameters
- `429`: Too Many Requests — rate limit of 4 requests per second per IP exceeded.

---

[API](https://skmtc.dev/openarchieven/apis/open-archives-api.md) · [All operations](https://skmtc.dev/openarchieven/apis/open-archives-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openarchieven/apis/open-archives-api/revisions/4ff4685dd9e9?raw)