Standardize Custom Job Titles
Learn how to use the Skills Intelligence API to find the standardized jobs for a custom job title.
Introduction
The Jobs Library API allows you to submit up to 10 custom job titles and get the top matched standardized jobs from the Visier platform.
In this tutorial, you will learn how to use the Jobs Library API to find the standardized jobs that correspond to a custom job title. To demonstrate we'll take you through a hypothetical scenario where we use the API to answer a business question.
You will learn how to:
- Send custom job titles and get a list of standardized jobs
Prerequisites
Before beginning this tutorial, you will need:
- An API key. See API Authentication.
- An API client such as Postman
Scenario
Our hospital is experiencing high staff turnover and we need to determine which jobs are most affected. However, different departments have different job titles for the same role which is making it extremely difficult to conduct an accurate analysis for turnover. We need to establish a standard for all job titles in order to gain insight into our turnover patterns.
Steps
Gather current job titles
To get started we have requested a list of employee details from our HR department which include job title and department. By looking through the list, we can see there are similar roles in different departments with different titles.
Now that we have a list of titles we can use the v1/jobs/standardize endpoint to standardize our job titles to a standard taxonomy which will allow us to effectively analyze turnover.
Standardize job titles
Let's send a request to return the top matched standardized jobs for the first 10 job titles on our list.
POST https://{vanity_name}.api.visier.io/v1/jobs/standardize
We will replace the {vanity_name} with our tenant name jupiter and include the API key as a header.
Copy
cURL sample request: standardize job titles
curl -X POST --url 'https://jupiter.api.visier.io/v1/jobs/standardize' \
-H 'apikey: 12345'Copy
JSON request body
{
"jobs": [
"admin assistant", "admissions clerk", "ambulatory data clerk", "analyst", "anesthesiologist", "benefits coordinator", "booking secretary", "cardiac nurse", "care coordintator"
]
}The response will return a list of standardized job matches with the following fields:
|
Field |
Description |
|---|---|
|
id |
The unique ID of the job. |
|
name |
The localized display name of the job. |
|
description |
The localized description of the job. |
|
score |
The score representing the confidence level of the match between the job title and the standardized job in Visier's job taxonomy. It ranges from 0-100, where a higher score indicates a better match. |
Copy
Sample response: Standardized job matches for 10 job titles
[
{
"job": "admin assistant",
"matches": [
{
"id": "3011",
"name": "Administrative assistant",
"description": "People in this job provide administrative and office support for supervisors. They perform a variety of tasks, such as answering telephone calls, receiving and directing visitors, ordering office supplies, maintaining the office facilities running smoothly, and ensuring that equipment and appliances work properly.",
"score": 94
},
{
"id": "4648",
"name": "Management assistant",
"description": "People in this job perform varied types of jobs, usually under general supervision. They carry out administrative tasks and support managers to ensure the entire department functions smoothly.",
"score": 81
},
{
"id": "4050",
"name": "Secretary",
"description": "People in this job perform a variety of administrative tasks to help keep an organisation run smoothly. They answer telephone calls, draft and send e-mails, maintain diaries, arrange appointments, take messages, file documents, organise and service meetings, and manage databases.",
"score": 78
},
{
"id": "3456",
"name": "Executive assistant",
"description": "People in this job are advanced administrative professionals who work with top-level executives or in international facilities in various industries. They organise meetings, organise and maintain files, arrange travel, train staff members, communicate in other languages, and manage the day-to-day operations of the office.",
"score": 77
},
{
"id": "4728",
"name": "Engineering assistant",
"description": "People in this job ensure the administration and monitoring of technical and engineering files for projects, assignments, and quality matters. They assist engineers with their experiments, participate in site visits, and administer the collection of information.",
"score": 70
}
]
},
{
"job": "admissions clerk",
"matches": [
{
"id": "4270",
"name": "Admissions coordinator",
"description": "People in this job are in charge of the students' applications and admissions to a (private) school, college or university. They assess possible future students' qualifications and subsequently approve or deny their application, based on the regulations and desires set by the board of directors and the school administration. They also assist the accepted students in their enrollment in the programme and courses of their choice.",
"score": 82
},
{
"id": "4120",
"name": "Ticket issuing clerk",
"description": "People in this job provide service to customers, sell tickets and fit the reservation offer to customers' needs. They sell tickets for all events such as sporting, cultural and leisure activities. They provide customers with information on offers and make the necessary arrangements.",
"score": 63
},
{
"id": "4152",
"name": "Data entry clerk",
"description": "People in this job update, maintain and retrieve information held on computer systems. They prepare source data for computer entry by compiling and sorting information, process customer and account source documents by reviewing data for deficiencies and verify entered customer and account data.",
"score": 62
},
{
"id": "3508",
"name": "Academic support officer",
"description": "People in this job provide assistance to students with learning problems and act as the main point of contact for these students. They make sure extra tuition and educational programmes are provided to under-represented students with academic or personal issues. They also organise several social activities throughout the academic year.",
"score": 57
},
{
"id": "4142",
"name": "Immigration officer",
"description": "People in this job monitor the eligibility of people, food, electronic devices and merchandise entering a country via an entry point. They use surveillance methods and check identification and documents to ensure entry criteria and custom laws are complied with. They can also conduct interviews with prospective immigrants to verify eligibility and inspect cargo to identify and detect violations.",
"score": 55
}
]
},
{
"job": "ambulatory data clerk",
"matches": [
{
"id": "4152",
"name": "Data entry clerk",
"description": "People in this job update, maintain and retrieve information held on computer systems. They prepare source data for computer entry by compiling and sorting information, process customer and account source documents by reviewing data for deficiencies and verify entered customer and account data.",
"score": 84
},
{
"id": "3208",
"name": "Medical records clerk",
"description": "People in this job organise, keep up-to-date and archive patients` records for medical staff availability. They transfer medical information from a patients paper records to an electronic template.",
"score": 77
},
{
"id": "3013",
"name": "Medical administrative assistant",
"description": "People in this job work very closely with health professionals. They provide office support such as consultants` correspondence, fixing appointments and answering queries of patients.",
"score": 70
},
{
"id": "5446",
"name": "Healthcare assistant",
"description": "People in this job work in teams of nurses within the occupational fields of nursing, social care, clinical care and care of people of all age-groups. They assist in the promotion and restoration of patients' health by providing physical and psychological support to patients, friends and families.",
"score": 61
},
{
"id": "4076",
"name": "Medical transcriptionist",
"description": "People in this job interpret dictated information from the doctor or other healthcare professionals and convert it into documents. They create, format and edit medical records for patients based on the provided data and take care to apply punctuation and grammar rules.",
"score": 58
}
]
},
{
"job": "analyst",
"matches": [
{
"id": "4107",
"name": "Business analyst",
"description": "People in this job research and understand the strategic position of businesses and companies in relation to their markets and their stakeholders. They analyse and present their views on how the company, from many perspectives, can improve its strategic position and internal corporate structure. They assess needs for change, communication methods, technology, IT tools, new standards and certifications.",
"score": 89
},
{
"id": "5451",
"name": "Data analyst",
"description": "People in this job import, inspect, clean, transform, validate, model, or interpret collections of data with regard to the goals of the company. They ensure that the data sources and repositories provide consistent and reliable data. They use different algorithms and IT tools as demanded by the situation and the current data. They might prepare reports in the form of visualisations such as graphs, charts, and dashboards.",
"score": 81
},
{
"id": "4254",
"name": "Occupational analyst",
"description": "People in this job collect and analyse occupational information within one field or company in order to make recommendations for reducing costs and general business improvements. They provide technical assistance to employers in dealing with problematic staff recruitment and development and with staff restructuring. They study and write job descriptions and prepare occupational classification systems.",
"score": 81
},
{
"id": "5357",
"name": "Accounting analyst",
"description": "People in this job evaluate the financial statements of clients, usually companies, which include the income sheet, the balance sheet, the statement of cash flows and additional notes to other financial statements. They interpret and implement new accounting systems and accounting procedures and will analyse and determine if the proposed systems conform to accounting regulations and meet user information requirements.",
"score": 80
},
{
"id": "4657",
"name": "Financial analyst",
"description": "People in this job conduct economic research and elicit valuable analyses on financial matters such as profitability, liquidity, solvency, and asset management. They provide recommendations on financial matters for decision-making processes. They work in both the public and the private sector.",
"score": 78
}
]
},
{
"job": "anesthesiologist",
"matches": [
{
"id": "3230",
"name": "Anaesthetic technician",
"description": "People in this job assist specialised doctors in anaesthetics. They prepare operating theatres and other specialised clinics for anaesthetic procedures, prepare the equipment needed for anaesthesia, and assist with inducing and maintaining adequate anaesthesia and post-anaesthesia procedures. They do so under supervision, following the orders of the doctor of medicine.",
"score": 88
},
{
"id": "4819",
"name": "Specialised doctor",
"description": "People in this job prevent, diagnose and treat diseases depending on their medical or surgical specialty.",
"score": 77
},
{
"id": "3101",
"name": "Doctor surgery assistant",
"description": "People in this job support doctors of medicine in medical measures, in performing simple support activities during medical procedures, standardised diagnostic programmes and standardised point-of-care tests, ensuring surgery hygiene, cleaning, disinfecting, sterilising and maintaining medical devices and performing the organisational and administrative tasks required for operating a doctor`s surgery under supervision, following the orders of the doctor of medicine.",
"score": 67
},
{
"id": "4313",
"name": "General practitioner",
"description": "People in this job promote health, prevent, identify ill health, diagnose and treat diseases and promote recovery of physical and mental illness and health disorders of all kinds for all persons regardless of their age, sex or type of health problem.",
"score": 62
},
{
"id": "4692",
"name": "Prosthetist-orthotist",
"description": "People in this job design and custom fit prostheses and orthoses for individuals who are missing a limb from accident, disease or congenital conditions or for individuals who have impairments, deficiences or weaknesses due to injury, pathology or congenital malformation. They mix patient care with the design and fabrication of these devices to address their patients' needs.",
"score": 58
}
]
},
{
"job": "benefits coordinator",
"matches": [
{
"id": "11944",
"name": "Compensation and benefits manager",
"description": "People in this job are responsible for the administration of employee benefits in all company operations.",
"score": 91
},
{
"id": "3863",
"name": "Benefits advice worker",
"description": "People in this job guide individuals in the social work area to help them solve specific problems in their personal life by addressing personal and relationship issues, inner conflicts, depression and addictions. They attempt to empower individuals to achieve change and improve the quality of their life. They may also support and advise clients on demanding their social security benefits.",
"score": 82
},
{
"id": "18873",
"name": "Compensation and benefits specialist",
"description": "People in this job are responsible for analyzing compensation data within an organization and evaluating job positions to determine classification and salary. They administer employee insurance, pension and savings plans.",
"score": 82
},
{
"id": "5407",
"name": "Social security administrator",
"description": "People in this job direct and develop government-provided social security programmes in order to aid public welfare, as well as promote social security programmes. They supervise staff working in governmental social security, and investigate existing policies in order to assess issues and develop improvement proposals.",
"score": 72
},
{
"id": "5251",
"name": "Social services manager",
"description": "People in this job have the responsibility for strategic and operational leadership and management of staff teams and resources within and or across social services. They are responsible for the implementation of legislation and policies relating to, for example, decisions about vulnerable people. They promote social work and social care values and ethics, equality and diversity, and relevant codes guiding practice. They are responsible for liaising with other professionals in criminal justice, education and health. They can be responsible for contributing to local and national policy development.",
"score": 69
}
]
},
{
"job": "booking secretary",
"matches": [
{
"id": "4519",
"name": "Hospitality establishment receptionist",
"description": "People in this job provide first point of contact and assistance to the guests of a hospitality establishment. They are also responsible for taking bookings, processing payments and giving information.",
"score": 81
},
{
"id": "5207",
"name": "Ticket sales agent",
"description": "People in this job provide initial service to customers, sell travel tickets and fit the reservation offer to customers' queries and needs.",
"score": 79
},
{
"id": "5803",
"name": "Receptionist",
"description": "People in this job are responsible for the reception area of a business. They answer the phone, greet guests, pass information, respond to inquiries and instruct visitors. They are the first point of contact for clients and customers.",
"score": 74
},
{
"id": "4120",
"name": "Ticket issuing clerk",
"description": "People in this job provide service to customers, sell tickets and fit the reservation offer to customers' needs. They sell tickets for all events such as sporting, cultural and leisure activities. They provide customers with information on offers and make the necessary arrangements.",
"score": 73
},
{
"id": "4423",
"name": "Travel agent",
"description": "People in this job design and market travel programme itineraries for potential travellers or visitors.",
"score": 71
}
]
},
{
"job": "cardiac nurse",
"matches": [
{
"id": "3255",
"name": "Specialist nurse",
"description": "People in this job promote and restore people's health, and diagnose and care within a specific branch of the nursing field. Examples of such specialist nursing jobs include but are not restricted to: ambulatory care nurse, advanced practice nurse, cardiac nurse, dental nurse, community health nurse, forensic nurse, gastroenterology nurse, hospice and palliative care nurse, paediatric nurse, public health nurse, rehabilitation nurse, renal nurse and school nurse. They are general care nurses prepared beyond the level of a nurse generalist and authorised to practice as specialists with specific expertise in a branch of the nursing field.",
"score": 85
},
{
"id": "4653",
"name": "Nurse responsible for general care",
"description": "People in this job are in charge of promoting and restoring patients' health by providing physical and psychological support to patients, friends, and families. They also supervise assigned team members.",
"score": 73
},
{
"id": "8488",
"name": "Nurse in a nursing home",
"description": "People in this job are responsible for maintaining, improving the patient's state of health and independence by providing care. They must adapt the support according to the particularities of each one of them.",
"score": 70
},
{
"id": "8489",
"name": "Home health nurse",
"description": "People in this job work on their own account or for an office. They move to the patients' homes to treat them. They have to carry all their equipment with them and do the care in a given time.",
"score": 67
},
{
"id": "4581",
"name": "Nurse assistant",
"description": "People in this job provide basic patient care under direction of nursing staff. They perform duties such as feed, bathe, dress, groom, move patients or change linens and may transfer or transport patients.",
"score": 65
}
]
},
{
"job": "care coordintator",
"matches": [
{
"id": "4048",
"name": "Mental health support worker",
"description": "People in this job assist and provide treatment to people with mental, emotional, or substance abuse problems. They focus on personalised cases and monitor the recovery process of their clients, providing also therapy, crisis intervention, client advocacy and education.",
"score": 80
},
{
"id": "4937",
"name": "Mental health social worker",
"description": "People in this job assist and provide counselling to people with mental, emotional, or substance abuse problems. They focus on providing personalised support to cases and monitor the recovery process of their clients by providing therapy, crisis intervention, client advocacy and education. They may contribute to mental health services improvement and mental health outcomes for citizens.",
"score": 77
},
{
"id": "4510",
"name": "Residential care home worker",
"description": "People in this job follow a specific plan to provide day-to-day care to clients. They develop a client-focused environment in the care homes where they work. They look after the physical and mental wellbeing of clients by providing social care in residential centres",
"score": 74
},
{
"id": "4417",
"name": "Residential home adult care worker",
"description": "People in this job counsel and support vulnerable adults who have physical or mental disabilities or addiction issues. They monitor their progress and provide them with care in a positive living environment. They work with families to support individuals' development and meet their needs.",
"score": 74
},
{
"id": "4559",
"name": "Community care case worker",
"description": "People in this job perform assessment and care management. They organise domiciliary services to support vulnerable adults who are living with physical impairment or convalescing, aiming to improve their lives in the community and enabling them to live safely and independently at their own home.",
"score": 68
}
]
}
]Looking at the response we can see the top standardized job matches for the custom job titles we included in our request.
Line 73 specifies the custom job title we included in our request, for example ambulatory data clerk.
Line 74 is where the matches for the job title ambulatory data clerk begin in the response.
Line 79 shows the match score between the job title ambulatory data clerk and the standardized job Data entry clerk is 84. The higher score indicates a better match compared to the rest of the jobs provided in the list.
As we move through the response, we will take note of the top matched standardized jobs for each title. By doing we are creating a standard taxonomy which will allow us to effectively analyze turnover.
We can continue to call /v1/jobs/standardize to get the top matching standardized jobs for the remaining job titles in our list.
Now you know how to send custom job titles and retrieve a list of standardized jobs from the Visier platform. This API extends to other use cases as well including internal communication, compensation, career planning and more.