---
title: "Profession frequency statistics"
method: GET
path: "/stats/professions.json"
tags: ["Stats"]
---

# Profession frequency statistics

`GET /stats/professions.json`

## Request

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

Returns the number of times professions appear in records for the selected period and place. Results are ordered by frequency. Open Archives uses this endpoint to power its profession frequency visualisation.

## Query parameters

- `eventplace` string
- `eventyearstart` integer
- `eventyearend` integer
- `number_show` integer
- `lang` 'nl' | 'en' | 'de' | 'fr'
- `callback` string

## Response `200`

Google DataTable-style response with profession 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)