Skip to content
Skills Intelligence
Normalize professions
latest

Normalize professions🔗

The /normalize endpoint is a REST service offered via a POST method.

It will map the provided job titles to the supported professions taxonomies:

  • if a job title can be mapped to the professions taxonomy, return its normalized code ids and descriptions
  • if a job title cannot be mapped to the professions taxonomy, return Unknown

Remember to send your authentication token with each request (see Authentication page).

Endpoint🔗

Method Media URL Description
POST application/json {{domain}}/normalize Normalize a list of job titles

Input parameters🔗

Parameter Type Default Description
job_titles array None The list of job titles to normalize (up to 10 job titles, each job title may not exceed 400 characters).
language str None The language of the input job titles (ISO 639-1 code; see list of supported languages)
output_language str same as language The language or locale of the normalized professions (ISO639-1 language code or ISO639-1_ISO3166-1 locale code; see list of supported languages)

If the locale requested in output_language is not supported, the normalization will be returned in the language that is extracted from the locale (e.g. en if the locale is en_XX). If the provided language is not supported either, the normalization will be returned in English.

Response🔗

Status Content type Content description
200 (OK) application/json A JSON object containing:
  • professions: the list of normalized professions
  • meta: the meta information of the service (including the service library version)
400 (Bad request) The input request body is incorrect
404 (Not Found) The language is not supported
422 (Validation error) The input value does not match the expected format or content

Example🔗

$ curl -s -X POST https://api.textkernel.nl/professions/v1/normalize \
    -H "Authorization: Bearer $TOKEN" \
    -H "accept: application/json" -H "Content-Type: application/json" \
    -d '{"job_titles": ["human resources adviser", "product manager"], "language": "en", "output_language": "en_US"}'

{
  "professions": [
    {
      "tk": {
        "class": {
          "code_id": 19,
          "description": "Legal, Human Resources and Social Services"
        },
        "group": {
          "code_id": 223,
          "description": "Personnel and Labor Experts"
        },
        "code_id": 11,
        "description": "HR Advisor"
      },
      "onet": {
        "code_id": "13_1071_00",
        "description": "Human Resources Specialists"
      },
      "isco": {
        "code_id": 2423,
        "description": "Personnel and careers professionals"
      },
      "onet_2019": {
        "code_id": "13-1071.00",
        "description": "Human Resources Specialists"
      },
      "kldb_2020": {
        "code_id": "71524",
        "description": "Occupations in recruiting and employment services-highly complex tasks"
      },
      "uwv_boc": {
        "code_id": "10808",
        "description": "Personeelsfunctionaris"
      },
      "uk_soc_2010": {
        "code_id": "3562",
        "description": "Human resources and industrial relations officers"
      },
      "uk_soc_2020": {
        "code_id": "3571",
        "description": "Human resources and industrial relations officers"
      },
      "ams": {
        "code_id": "1113",
        "description": "PersonalberaterIn"
      },
      "confidence": 1
    },
    {
      "tk": {
        "class": {
          "code_id": 23,
          "description": "Communication, Marketing and Public Relations"
        },
        "group": {
          "code_id": 208,
          "description": "Communication, Marketing and Public Relations Managers"
        },
        "code_id": 3178,
        "description": "Product Manager"
      },
      "onet": {
        "code_id": "11_2021_00",
        "description": "Marketing Managers"
      },
      "isco": {
        "code_id": 2431,
        "description": "Advertising and marketing professionals"
      },
      "onet_2019": {
        "code_id": "11-2021.00",
        "description": "Marketing Managers"
      },
      "kldb_2020": {
        "code_id": "71393",
        "description": "Supervisors in business organisation and strategy"
      },
      "uwv_boc": {
        "code_id": "11297",
        "description": "Productmanager"
      },
      "uk_soc_2010": {
        "code_id": "2150",
        "description": "Research and development managers"
      },
      "uk_soc_2020": {
        "code_id": "2161",
        "description": "Research and development (R&D) managers"
      },
      "ams": {
        "code_id": "1195",
        "description": "ProduktmanagerIn"
      },
      "confidence": 1
    }
  ],
  "trace_id": "9111ca10-6ad5-11eb-83b7-b66bce27954b",
  "meta": {
    "service_version": "1.2.0"
  }
}

Response fields🔗

Field Type Value
profession.tk.code_id int The code id of the TK profession concept
profession.tk.description str The description of the TK profession concept
profession.tk.group.code_id int The code id of the group to which the TK profession concept belongs
profession.tk.group.description str The description of the group to which the TK profession concept belongs
profession.tk.class.code_id int The code id of the class to which the TK profession concept belongs
profession.tk.class.description str The description of the class to which the TK profession concept belongs
profession.onet.code_id str The code id of the ONET-2010 Occupation (DEPRECATED - to be removed January 2025)
profession.onet.description str The description of the ONET-2010 Occupation (DEPRECATED - to be removed January 2025)
profession.isco.code_id str The code id of the ISCO profession concept
profession.isco.description str The description of the ISCO profession concept
profession.onet_2019.code_id str The code id of the ONET-2019 profession concept
profession.onet_2019.description str The description of the ONET-2019 profession concept
profession.kldb_2020.code_id str The code id of the KldB-2020 profession concept
profession.kldb_2020.description str The description of the KldB-2020 profession concept
profession.uwv_boc.code_id str The code id of the UWV profession concept
profession.uwv_boc.description str The description of the UWV profession concept (Dutch only)
profession.uk_soc_2010.code_id str The code id of the UK-SOC-2010 profession concept
profession.uk_soc_2010.description str The description of the UK-SOC-2010 profession concept
profession.uk_soc_2020.code_id str The code id of the UK-SOC-2020 profession concept
profession.uk_soc_2020.description str The description of the UK-SOC-2020 profession concept
profession.ams.code_id str The code id of the AMS profession concept
profession.ams.description str The description of the AMS profession concept (German only)
profession.confidence float Overall confidence that the input job title was normalized to the correct profession concept

Note: an Unknown normalized profession is returned under two scenarios:

  • when the input string does not contain a job title
  • when the confidence on the normalized profession is too low

Rate limits🔗

Accounts have a limited request rate. If you exceed the limit you will receive 429 Too Many Requests HTTP responses.

Plan Limit Units
Standard 800 Minute
Demo 30 Minute