Recommend open jobs for job seekers based on their work history, education, skills, and any completed programs from an AdeptID training provider partner.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

Use this endpoint when you are looking to recommend open jobs to a job seeker based on their work history, education, skills and completed programs from an AdeptID training provider partner. This endpoint accepts the individual’s (candidate’s) profile, including an optional history of their completed programs from AdeptID training provider partners, and a set of filters/search criteria (e.g., the job location). It returns a ranked list of open jobs with match assessments for each job.

Note: This is a value-added service and is not available by default. To access this service, please contact your AdeptID Partner Success team.

Additional Notes:

  • Program History: As a feature of this endpoint, callers have the option to specify training program(s) completed by the candidate (job seeker). Training programs are specific to the caller’s organization and must be configured with AdeptID prior to this feature being used.
  • Feedback Collection: Recommend Jobs Feedback can be used to collect and share user feedback on the results of this endpoint.
  • Education Levels: Jobs not specifying a preferred or required minimum level of education are excluded if education level filters are specified. Approximately half of job postings do not specify an education level, and therefore will not be returned in this scenario.
  • Salary Ranges: Jobs not specifying a salary are excluded if salary filters are specified. Approximately half to two-thirds of job postings do not specify a salary, and therefore will not be returned in this scenario.
Body Params
number
0 to 1
Defaults to 0.7

Include results with this match score or higher. Score must be between 0 and 1 inclusive.

integer
Defaults to 0

Number of rows/recommendations to exclude from the beginning of the ordered results set.

integer
0 to 100
Defaults to 10

Number of rows/recommendations to include in the results set.

string

The type of employment. Full-time time jobs are > 32 hours per week. Values: full_time, part_time, all.

boolean
Defaults to false

True includes remote jobs (vs. in-person) in addition to non-remote jobs.

metro
array of strings

The Metropolitan Statistical Area(s) searched for jobs. If remote is True and at least one metro is provided, results may include remote jobs as well as jobs in the specified metros.

metro
education_levels
array of strings

Array of strings representing canonical degree levels. Results include jobs that specify any included degree level as the minimum or preferred required level of education. If not null, results will exclude jobs without a specified minimum.

education_levels
integer

Minimum salary range. Results include jobs with a salary above salary_min. Jobs not specifying salary excluded if salary_min or salary_max are specified.

integer

Maximum salary range. Results include jobs with a salary below salary_min. Jobs not specifying salary excluded if salary_min or salary_max are specified.

candidate
object
required

AdeptID's standard Candidate object. Describes the job seeker to be matched to job and career opportunities.

string
Defaults to include

Determines if search should return only internships, include a mix of internships and non-internships, or exclude internships. Values: only, include, exclude.

integer
Defaults to 5

The number of skill overlaps and gaps returned for each job.

Responses

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json