Recommends next step career opportunities for a specific candidate based on their career interests, work history, education and skills.
Use this endpoint when you have users who are exploring next-step careers and those users have completed a career interest assessment. This endpoint accepts a candidate and the results of one or more career interest surveys as inputs and returns a list of occupations and a match associated with each occupation. Matches consist of a match score and list of skill overlaps and skill gaps.
Career interest surveys are compatible with this endpoint if the results are expressed in O*NET Career Clusters or O*NET Major Group. The results may be be numerical scores or ranks in descending order.
Calculating Match Scores:
This endpoint blends together scores from AdeptID's match models and from career interest surveys. Match scores are delivered as a weighted average with the developer specifying the weights to use as part the score_weights object.
Scores are calculated as follows:
match_score = adept_id_match_weightx adept_id_match_score + career_cluster_weightxcareer_cluster_score + major_group_score x major_group_weight
Using the Score Weight Object:
- Score weights must sum to 1 and each score weight must be between 0 and 1 (inclusive).
- A score weight must be provided for the AdeptID match and for any of
career_cluster_scoreandmajor_group_scoresthat are included in the input payload. Weights may not be provided for surveys which are not present in the input payload.
Score Scaling: The system scales survey scores to values between 0 and 1 by dividing each score in the input array by the maximum value in that array.
Additional Notes:
- Appending Additional Data: Occupation Metadata can be used to append additional information such as typical salaries to the results.
- Occupation Taxonomy: The results returned are in the ONET 2019 Simplified taxonomy. See the Occupation page in our documentation center for more details.
- Dates: If both are populated within an object, start_date cannot be after end_date.