VacancyAnalysis
The VacancyAnalysis endpoint is designed to assist you in generating inputs required for building a vacancy_application_flow. This endpoint provides a list of skills associated with a particular vacancy and denotes their relevance.
It is essential to note that this endpoint is specifically created to generate inputs for vacancy_application_flow, and therefore, individual calls will not be billed. This endpoint is not meant to act as a standalone service. Please consider using this endpoint as fair use. A rate may be put in place in cases of excessive usage relative to the number of flows being generated.
In the sandbox environment, synchronous vacancy analysis is permitted. This implies that our system will hold the response to the POST request until the flow has been completely generated.
This feature is incredibly useful for development and testing purposes as it negates the need for implementing full webhook handling. To access this feature, append the query parameter ?sync=true to the POST request.
This feature is not available in the production environment.
Endpoints
GET /vacancy-analyses- Retrieves a list of all vacancy analyses.GET /vacancy-analyses/{id}- Retrieves a specific vacancy analysis by ID.POST /vacancy-analyses- Generates a new vacancy analysis.DELETE /vacancy-analyses/{id}- Deletes a specific vacancy analysis by ID.
Attributes
inputText
String
The vacancy description to analyze
HTTP Methods
inputText
X
X
analyzeResult
X
Required Fields for Creation (POST)
inputText
String
"Example Text"
AnalyzedResult attributes
hardSkills
Array of Objects
A list of hard skills extrapolated from the vacancy description. Each object in the list has the keys skill, rating, reasoning, and writtenAsRequirement.
softSkills
Array of Objects
A list of soft skills extrapolated from the vacancy description. Each object in the list has the keys skill, rating, reasoning, and writtenAsRequirement.
certifications
Array of Objects
A list of certifications extrapolated from the vacancy description. Each object in the list has the keys required, reasoning, certification, and writtenAsRequirement.
languageRequirements
Array of Objects
A list of language requirements extrapolated from the vacancy description. Each object in the list has the keys language, required, reasoning, proficiency, and writtenAsRequirement.
educationalQualifications
Array of Objects
A list of educational qualifications extrapolated from the vacancy description. Each object in the list has the keys qualification, required, reasoning, and writtenAsRequirement.
createdAt
Timestamp
The timestamp when the vacancy analysis was created.
updatedAt
Timestamp
The timestamp when the vacancy analysis was last updated.
suggested
Array of Objects
Suggested input for FlowGeneration.
FAQ
What is the "suggested" key?
The "suggested" key contains recommendations for the requirements that we advise you to use as input for the FlowGeneration. If you want to keep the flow as short as possible we suggest only including the requirements with the "active":true flag. These recommendations are calculated based on our experience and the ratings determined by the AI.
What does a "rating" mean in the skills section?
The "rating" is a heuristic score representing the relevance or importance of a particular skill for the vacancy, as interpreted from the description. It is an integer value ranging from 0 to 7.
What is the difference between "hardSkills" and "softSkills"?
"hardSkills" are specific, teachable abilities that can be defined and measured, such as the ability to use a certain software, tool, or carry out a specific procedure. "softSkills", on the other hand, are less tangible and harder to quantify, such as teamwork, communication skills, or flexibility.
What are the educational qualifications?
These are academic qualifications extrapolated from the vacancy description. If no qualifications are explicitly mentioned, this list will be empty.
Why are there booleans in "certifications" and "languageRequirements"?
The required field in these sections indicates whether the language or certification is explicitly required in the vacancy description according to the analysis.
Limitations and Considerations
This API endpoint uses Natural Language Processing (NLP) techniques to understand and extrapolate information from vacancy descriptions. Due to the nature of NLP, there may be some inaccuracies, especially if the vacancy description is vague, poorly worded, or lacks detail.
The entire "VacancyAnalysis" endpoint, including the "rating" system, is currently experimental. It provides an automated preliminary analysis of job descriptions, but results may not always match human evaluation. We recommend using this endpoint as a supplementary tool and exercising your professional judgment when making decisions based on its output.
Example POST body
Example Analyses result
OpenAPI
Last updated