Occupations

⚡ Built-in — Platform Built-in

Read-only beroepenreferentie: beroepen, job zones, skills, abilities, work styles, interessetypes en gerelateerde beroepen. Gebruik get-occupation-profile voor één beroep compleet in plaats van losse endpoints te combineren. Data is statisch per release en wordt gecached. Elke response draagt een verplicht attributieveld dat op elke publiek zichtbare weergave getoond moet worden.

⚡ Built-in — No Setup Required This integration is built into the WebsitePublisher platform. All endpoints are available immediately — no API key needed.

Endpoints (4)

GET get-occupation-profile

Haal één beroep compleet op: titel, beschrijving, job zone met toelichting, alle descriptorwaarden en gerelateerde beroepen. Geef onetsoc_code in O*NET-SOC-formaat, bijvoorbeeld "15-1252.00". Het antwoord bevat een coverage-object dat per domein aangeeft of er data was — niet elk beroep heeft elke descriptor, en een ontbrekend domein is een feit en geen fout.

Field	Type	Required	Description
`onetsoc_code`	string	✓ Yes	O*NET-SOC-code in het formaat NN-NNNN.NN, bijvoorbeeld "15-1252.00" (Software Developers).
`domains`	array	No	Welke descriptordomeinen meegeleverd worden. Toegestaan: essential_skills, transferable_skills, abilities, knowledge, work_activities, work_styles, career_interest_types. Standaard: essential_skills, transferable_skills, abilities, work_styles, career_interest_types.
`include_related`	string	No	Zet op "false" om gerelateerde beroepen weg te laten. Standaard worden ze meegeleverd.

POST match-elements

Match vrije teksttermen tegen de beroepentaxonomie en krijg kandidaat-elementen terug. Bedoeld voor skill-extractie: lever de termen die uit een CV komen, krijg gegronde taxonomie-elementen terug. Dit is een lexicale match op elementnaam en omschrijving — het is een kandidatenlijst, geen beslissing. De keuze welk kandidaat telt hoort in de scoringlaag, niet hier.

Field	Type	Required	Description
`terms`	array	✓ Yes	Lijst van te matchen termen. Maximaal 50 per aanroep, elk maximaal 100 tekens.
`domains`	array	No	Beperk de match tot deze domeinen. Toegestaan: essential_skills, transferable_skills, abilities, knowledge, work_activities, work_styles, career_interest_types. Standaard: essential_skills en transferable_skills.
`limit_per_term`	string	No	Maximaal aantal kandidaten per term, 1 tot 25. Standaard 10.

GET list-occupations

Blader of zoek door de beroepenlijst. Geeft code, titel en beschrijving. Gebruik search om op titel te filteren.

Field	Type	Required	Description
`search`	string	No	Zoekterm op beroepstitel. Minimaal 2 tekens.
`page`	string	No	Paginanummer, vanaf 1. Standaard 1.
`per_page`	string	No	Aantal per pagina, 1 tot 100. Standaard 25.

GET get-release

Geef de geladen release terug: label, laaddatum, bron-URL, sha256 van het bronarchief en welke bestanden bewust niet geladen zijn. Gebruik dit om rekentraces te verankeren — een opgeslagen score hoort te kunnen aanwijzen tegen welke releasedata hij berekend is.

No input parameters required.

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
get-occupation-profile	`occupations_get_occupation_profile`
match-elements	`occupations_match_elements`
list-occupations	`occupations_list_occupations`
get-release	`occupations_get_release`

← Back to all integrations