Website
Occupations
Read-only beroepenreferentie: beroepen, job zones, skills, abilities, work styles, interessetypes, gerelateerde beroepen, functietitels en software. 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.
Endpoints (6)
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. |
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 hele woorden in elementnaam en omschrijving; termen van 1-2 tekens matchen alleen exact. Elke term levert precies één resultaat op — een term die niet gematcht kan worden komt terug met de reden in skipped. 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. |
Match functietitels (bijvoorbeeld uit een CV) en krijg kandidaat-beroepen terug, één per beroep: onetsoc_code, beroepstitel en de titel die het beste paste. Er wordt gezocht in de functietitels, in O*NET's verkorte titels ("IT Manager", "RN") en in de beroepstitels zelf; matched_field zegt welke bron raakte. Lexicale woordoverlap: een identieke titel scoort 1.0, en "Senior Software Developer" vindt ook "Software Developer". Termen van 1-2 tekens matchen alleen exact. Elke term levert precies één resultaat op — een term die niet gematcht kan worden komt terug met de reden in skipped. Het is een kandidatenlijst, geen beslissing.
| Field | Type | Required | Description |
|---|---|---|---|
terms |
array | ✓ Yes | Lijst van functietitels. Maximaal 50 per aanroep, elk maximaal 100 tekens. |
limit_per_term |
string | No | Maximaal aantal kandidaten per term, 1 tot 25. Standaard 10. |
Match softwarenamen (bijvoorbeeld uit een CV) tegen de softwarelijst en krijg het voorbeeld terug met de softwarecategorie (element_id en element_name uit het content model), het aantal beroepen dat het noemt, hot_technology en het aantal beroepen waarvoor het in demand is. Hele woorden: "Java" vindt geen "JavaScript". Namen en termen van 1-2 tekens, zoals "C" of "R", matchen alleen exact. Elke term levert precies één resultaat op — een term die niet gematcht kan worden komt terug met de reden in skipped. Het is een kandidatenlijst, geen beslissing.
| Field | Type | Required | Description |
|---|---|---|---|
terms |
array | ✓ Yes | Lijst van softwarenamen. Maximaal 50 per aanroep, elk maximaal 100 tekens. |
limit_per_term |
string | No | Maximaal aantal kandidaten per term, 1 tot 25. Standaard 10. |
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. |
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 |
| match-titles | occupations_match_titles |
| match-software | occupations_match_software |
| list-occupations | occupations_list_occupations |
| get-release | occupations_get_release |