Get Job Details
Learn how to use the Skills Intelligence Engine API to explore the data available in the Jobs Library.
Introduction
The Jobs Library API gives you access to a three layer hierarchy which contains over 3,300 standardized jobs and over 14,000 skills and more.
In this tutorial, you will learn how to explore the data available in the Jobs Library API and retrieve job details for a specific job.
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:
- Call the Jobs Library API to retrieve a list of all jobs
- Retrieve job details for a specific job ID
Prerequisites
Before beginning this tutorial, you will need:
- An API key. See API Authentication.
- An API client such as Postman.
Scenario
With the rise of technologies such as ChatGPT, automation has been a popular topic in our organization within the past year and is the focus of our upcoming planning meeting. In preparation for the meeting, we need to understand the skills associated with certain jobs in our organization and how many of these skills/jobs can be automated.
Steps
Request and retrieve jobs
To start exploring the data in the Jobs Library API, let’s send our first request to retrieve a list of all jobs.
GET https://{vanity_name}.api.visier.io/v1/jobs
In each request in this tutorial we will replace the {vanity_name} with our tenant name jupiter and include the API key as a header.
Copy
cURL sample request: Retrieve a list of all jobs
curl -X GET --url 'https://jupiter.api.visier.io/v1/jobs' \
-H 'apikey: 12345'The response will return a list of all jobs which includes 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. |
Copy
Sample response: A list of all jobs
[
…,
{
"id": "3948",
"name": "3D animator",
"description": "People in this job are in charge of animating 3D models of objects, virtual environments, layouts, characters and 3D virtual animated agents."
},
{
"id": "5162",
"name": "3D modeller",
"description": "People in this job design 3D models of objects, virtual environments, layouts, characters and 3D virtual animated agents."
},
{
"id": "6883",
"name": "3D printing operator",
"description": "People in this job set up, operate, clean and check the status of 3D printers. They do the final quality control analysis against specifications and quality requirements and are also responsible for the preparation of shipments of the finished products."
},
{
"id": "3874",
"name": "3D printing technician",
"description": "People in this job assist in the designing and programming of products, ranging from prosthetic products to 3D miniatures. They may also provide 3D printing maintenance, check 3D renders for customers and run 3D printing tests. 3D printing technicians can also repair, maintain and clean 3D printers."
},
{
"id": "4365",
"name": "able seaman",
"description": "People in this job are members of the deck department of an inland water transport ship. They may work on the helm, on the deck, in the cargo hold andin the engine room. They may be called on to use emergency, lifesaving, damage control, and safety equipment.they perform all operations connected with the launching of lifesaving equipment. They are expected to be able to operate deck machinery, mooring and anchoring equipment."
},
{
"id": "3679",
"name": "abrasive blasting operator",
"description": "People in this job use the proper equipment and machinery to smoothen rough surfaces by abrasive blasting. Abrasive blasting is commonly used in the finishing process of metal workpieces and for blasting building materials used in masonry such as bricks, stones and concrete. They operate blasters or sand cabinets which forcibly thrust a stream of abrasive material such sand, soda or water, under high pressure, propelled by a centrifigal wheel, in order to shape and smoothen surfaces."
},
…
]We can look through the list of jobs or we can narrow down the result by specifying a search term in our request.
Our request will look like the following:
GET https://jupiter.api.visier.io/v1/jobs/search?term=advisor
Copy
Sample response: A list jobs with the term 'advisor'
[
{
"id": "3071",
"name": "Motor vehicles parts advisor",
"description": "People in this job sell motor vehicle parts, order parts and identify alternative parts."
},
{
"id": "3726",
"name": "Humanitarian advisor",
"description": "People in this job ensure strategies to reduce the impact of humanitarian crises on a national and/or international level. They provide professional advice and support and this in collaboration with different partners."
},
{
"id": "3895",
"name": "Public funding advisor",
"description": "People in this job advise individuals and businesses about funding opportunities given by the government. They analyse the needs of clients, consult them on funds, grants and subsidies that apply to them and help with the application process. They also set up public grant administration in organisations."
},
{
"id": "4031",
"name": "Tax advisor",
"description": "People in this job use their expertise in tax legislation to provide commercially-focused advisory and consultancy services to a wide range of clients from all economic sectors. They explain complicated tax-related legislation to their clients and assist them in ensuring the most efficient and beneficial payment of taxes by devising tax-efficient strategies. They also inform them of fiscal changes and developments and may specialise in tax strategies concerning mergers or multinational reconstruction for business clients, trust and estate taxes for individual clients etc."
},
{
"id": "4072",
"name": "Career guidance advisor",
"description": "People in this job provide guidance and advice to adults and students on making educational, training and occupational choices and assist people in managing their careers, through career planning and career exploration. They help identify options for future careers, assist beneficiaries in the development of their curriculum and help people reflect on their ambitions, interests and qualifications. They may provide advice on various career planning issues and make suggestions for lifelong learning if necessary, including study recommendations. They may also assist the individual in the search for a job or provide guidance and advice to prepare a candidate for recognition of prior learning."
},
{
"id": "4988",
"name": "Academic advisor",
"description": "People in this job assist students, at post-secondary level, in recognising and achieving their educational goals. They advise students on their schedule selection of school programmes, communicate to them degree requirements, and assist them in career planning. They also discuss the student's academic performance and its implications and make suggestions for improvement including study advice. They also work closely with other university administrators and professors and ensure they are up to date on university or college regulation, program, or requirement changes."
},
{
"id": "5332",
"name": "Food regulatory advisor",
"description": "People in this job are extra-judicial or judiciary technical experts. They ensure food industry practices comply with the regulatory norms. They perform audits, make diagnosis and monitor activities of inspection. These experts have expertise in food processing, food analysis, quality, safety, certification, traceability. They update, review, and approve labelling designs, develop nutrition facts panels, and ensure that products and labels meet appropriate standards and regulations."
},
{
"id": "5365",
"name": "Consumer rights advisor",
"description": "People in this job aid consumers with complaints and provide advice and information on rights as a consumer after purchase of products or services. They monitor organisations to ensure compliance to consumer rights standards, and aid consumers in handling disputes."
},
{
"id": "5595",
"name": "Livestock advisor",
"description": "People in this job provide complex specialist advice to farmers and livestock breeders to ensure that their business and production is optimised."
}
]Request job details
By looking through the list, we find an job with the name “academic advisor” that matches one of the jobs in our organization that we want to learn more about.
Line 28 shows the ID 4988, which corresponds to academic advisor.
We will use the following request to retrieve job details for ID 4988.
GET https://jupiter.api.visier.io/v1/jobs/4988
The response will return a list of job details which includes 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. |
|
automationIndex |
The Automation Index score out of 100. This measures how effectively the job can be automated. This field will be omitted if automation is not applicable to the job. |
|
remoteIndex |
The Remote Index score out of 100. This measures how effectively the job can be performed remotely. This field will be omitted if remote work is not applicable to the job. |
|
alternativeTitles |
List of alternative localized names for this job. |
|
essentialSkills |
List of essential skills for this job. |
|
optionalSkills |
List of optional skills for this job. |
For more information, see Automation and Remote Index.
Copy
Sample response: A list of job details for job ID 4988
{
"id": "4988",
"name": "academic advisor",
"description": "People in this job assist students, at post-secondary level, in recognising and achieving their educational goals. They advise students on their schedule selection of school programmes, communicate to them degree requirements, and assist them in career planning. They also discuss the student's academic performance and its implications and make suggestions for improvement including study advice. They also work closely with other university administrators and professors and ensure they are up to date on university or college regulation, program, or requirement changes.",
"automationIndex": 13,
"remoteIndex": 100,
"alternativeTitles": [
"degree program guidance practitioner",
"academic student advisor",
"degree program advisor",
"higher education advisor",
"degree program coach",
"post-secondary level student advisor",
"education advisor",
"student career guide"
],
"essentialSkills": [
{
"id": "14333",
"name": "counselling methods",
"description": "Counselling techniques used in different settings and with various groups and individuals, especially concerning methods of supervision and mediation in the counselling process.",
"skillGroupId": "97",
"skillCategoryId": "15",
"alternativeTitles": []
},
{
"id": "15529",
"name": "curriculum standards",
"description": "The governmental policies concerning educational curricula and the approved curricula from specific educational institutions.",
"skillGroupId": "62",
"skillCategoryId": "28",
"alternativeTitles": []
},
{
"id": "16175",
"name": "assessment processes",
"description": "Various evaluation techniques, theories, and tools applicable in the assessment of students, participants in a programme, and employees. Different assessment strategies such as initial, formative, summative and self- assessment are used for varying purposes.",
"skillGroupId": "117",
"skillCategoryId": "23",
"alternativeTitles": []
},
{
"id": "18172",
"name": "education law",
"description": "The area of law and legislation that concerns education policies and the people working in the sector in an (inter)national context, such as teachers, students, and administrators.",
"skillGroupId": "124",
"skillCategoryId": "18",
"alternativeTitles": []
},
{
"id": "25990",
"name": "curriculum objectives",
"description": "The goals identified in curricula and defined learning outcomes.",
"skillGroupId": "62",
"skillCategoryId": "28",
"alternativeTitles": []
},
{
"id": "14522",
"name": "provide information on school services",
"description": "Present information on the educational and support services of a school or university to students and their parents, such as career guidance services or offered courses.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 15,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "15745",
"name": "construct individual learning plans",
"description": "Set up, in collaboration with the student, an individual learning plan (ILP), tailored to the student's specific learning needs, taking into account the student's weaknesses and strengths.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 16,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "16902",
"name": "provide information on study programmes",
"description": "Provide information on the different lessons and fields of study offered by educational institutions such as universities and secondary schools, as well as the study requirements and employment prospects.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 5,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "18506",
"name": "monitor educational developments",
"description": "Monitor the changes in educational policies, methodologies and research by reviewing relevant literature and liaising with education officials and institutions.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 9,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "26426",
"name": "encourage students to acknowledge their achievements",
"description": "Stimulate students to appreciate their own achievements and actions to nurture confidence and educational growth.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 18,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "26523",
"name": "advise on learning methods",
"description": "Provide advice to help students study in a way that suits them best, propose different techniques such as using visual highlighting or speaking out loud, and help them draw up summaries and create learning schedules.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 17,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "26526",
"name": "counsel students",
"description": "Provide assistance to students with educational, career-related or personal issues such as course selection, school adjustment en social integration, career exploration and planning, and family problems.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 13,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "27016",
"name": "Written communication",
"description": "Communicating effectively in writing as appropriate for the needs of the audience.",
"skillGroupId": "11",
"skillCategoryId": "17",
"alternativeTitles": []
},
{
"id": "26995",
"name": "Oral communication",
"description": "Talking to others to convey information effectively.",
"skillGroupId": "11",
"skillCategoryId": "17",
"alternativeTitles": []
},
{
"id": "28880",
"name": "Analytical skills",
"description": "Ability to analyze and research a problem or a topic, to decompose it in smaller pieces and develop an in-depth understanding about it",
"skillGroupId": "143",
"skillCategoryId": "9",
"alternativeTitles": []
},
{
"id": "26999",
"name": "Decision-making and judgement",
"description": "Considering the relative costs and benefits of potential actions in order to choose the most appropriate one",
"skillGroupId": "98",
"skillCategoryId": "25",
"alternativeTitles": []
},
{
"id": "14233",
"name": "Time management",
"description": "Maintain an overview of all the incoming tasks in order to prioritise the tasks, plan their execution, and integrate new tasks as they present themselves.",
"skillGroupId": "100",
"skillCategoryId": "23",
"alternativeTitles": []
},
{
"id": "13936",
"name": "Managing feedback",
"description": "Provide feedback to others. Evaluate and respond constructively and professionally to critical communication from colleagues and customers.",
"skillGroupId": "59",
"skillCategoryId": "7",
"alternativeTitles": []
}
],
"optionalSkills": [
{
"id": "14494",
"name": "learning needs analysis",
"description": "The process of analysing a student's learning needs through observation and testing, potentially followed by the diagnosis of a learning disorder and a plan for additional support.",
"skillGroupId": "62",
"skillCategoryId": "28",
"alternativeTitles": []
},
{
"id": "19640",
"name": "learning difficulties",
"description": "The learning disorders some students face in an academic context, especially Specific Learning Difficulties such as dyslexia, dyscalculia, and concentration deficit disorders.",
"skillGroupId": "62",
"skillCategoryId": "28",
"alternativeTitles": []
},
{
"id": "23591",
"name": "psychology",
"description": "The human behaviour and performance with individual differences in ability, personality, interests, learning, and motivation.",
"skillGroupId": "112",
"skillCategoryId": "15",
"alternativeTitles": []
},
{
"id": "24704",
"name": "university procedures",
"description": "The inner workings of a university, such as the structure of the relevant education support and management, the policies, and the regulations.",
"skillGroupId": "62",
"skillCategoryId": "28",
"alternativeTitles": []
},
{
"id": "24962",
"name": "labour market",
"description": "The trends, functioning, and fluctuations of the labour market, career options, wages, unions, working population and the supply and demand of certain professions in a sector.",
"skillGroupId": "71",
"skillCategoryId": "27",
"alternativeTitles": []
},
{
"id": "26078",
"name": "education administration",
"description": "The processes related to the administrative areas of an education institution, its director, employees, and students.",
"skillGroupId": "62",
"skillCategoryId": "28",
"alternativeTitles": []
},
{
"id": "13847",
"name": "cooperate with education professionals",
"description": "Communicate with teachers or other professionals working in education in order to identify needs and areas of improvement in education systems, and to establish a collaborative relationship.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 4,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "14004",
"name": "assist in the organisation of school events",
"description": "Provide assistance in the planning and organisation of school events, such as the school's open house day, a sports game or a talent show.",
"skillGroupId": "88",
"skillCategoryId": "8",
"automationIndex": 19,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "14589",
"name": "consult student's support system",
"description": "Communicate with multiple parties, including teachers and the family of the student, to discuss the student's behaviour or academic performance.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 19,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "20131",
"name": "identify education needs",
"description": "Identify the needs of students, organisations and companies in terms of provision of education in order to aid in the development of curricula and education policies.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 13,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "20428",
"name": "analyse education system",
"description": "Analyse various aspects of the school and education system, such as the relation between the cultural origin of the students and their educational opportunities, the apprenticeship programmes or the objectives of adult education, in order to make recommendations to education professionals and decision makers.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 5,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "21202",
"name": "promote education programmes",
"description": "Promote ongoing research into education and the development of new education programmes and policies in order to obtain support and funds, and to raise awareness.",
"skillGroupId": "62",
"skillCategoryId": "28",
"automationIndex": 39,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "22966",
"name": "organise job search workshops",
"description": "Organise group sessions for job seekers to teach them application techniques and to help them optimise their résumés and improve their interviewing skills.",
"skillGroupId": "117",
"skillCategoryId": "23",
"automationIndex": 22,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "23875",
"name": "provide information on education financing",
"description": "Provide information to parents and students concerning tuition fees, student loans and financial support services.",
"skillGroupId": "109",
"skillCategoryId": "13",
"automationIndex": 56,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "26848",
"name": "provide career counselling",
"description": "Advise beneficiaries on future career options through counselling and, potentially, through career testing and evaluation.",
"skillGroupId": "82",
"skillCategoryId": "15",
"automationIndex": 17,
"remoteIndex": 100,
"alternativeTitles": []
},
{
"id": "26872",
"name": "tackle issues that block academic progress",
"description": "Address the issues that can block a pupil's school progress, such as social, psychological, emotional or physical difficulties, through counselling and intervention methods.",
"skillGroupId": "112",
"skillCategoryId": "15",
"automationIndex": 16,
"remoteIndex": 100,
"alternativeTitles": []
}
]
}As a result we were able to see the automation index related to an academic advisor, as well as a list of essential and optional skills. We can also see the automation index for some of the listed skills.
Line 5 shows the automation index for an academic advisor is 13 which tells us that the possibility of automation for this job is low and we most likely will not be able to automate it.
Line 17 is where the list of essential skills begin in the response.
Line 177 is where the list of optional skills begin in the response.
Now that we have that information, we can call /v1/jobs to retrieve a list of all jobs and find the next job we are interested in learning more about. Once we find an job of interest, we will take note of the job ID and include it in our next request for additional details.
By continuing our exploration we will be able to understand the skills associated with certain jobs in our organization and how many of those skills/jobs can be automated.