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 profession concept
profession.onet.description	str	The description of the ONET profession concept
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