Candidate Search

Use this endpoint to search for candidates best fit for a job and matching a set of filters. During a search, candidate profiles are sourced from a specified candidate feed, filtered, and then ranked based on fit for the job.

• Job: The [Job] object describes the job’s responsibilities, requirements, and preferences in the form of a title, description, skills, languages, certifications, and more. This information is used to determine the best-fit candidates and to generate a [Match Report (link to Match page)] accompanying each recommended candidate.
• Filters: The caller may filter results based on candidate attributes such as location, experience requirements, and more.

Additional Notes:

• Access: To access this service and attain a candidate_feed_id, please contact your AdeptID Partner Success team.

• Custom Filters: Custom Filters - searchable scalar fields whose meaning is customer-defined - are searched by providing a list of strings, a boolean value, or ranges (for dates, integers, and floats) that match the desired candidate profile values. All provided filters must match for a candidate profile to be returned. For strings, the value must be an exact match for one of the values provided in the search filter. Ranges are specified by using min/max and before/after values.

• Normalizing Skills, Languages, and Certifications: Skills, languages, and certifications must be normalized before including them in the Candidate Search payload. AdeptID’s [Normalize Skills] API accepts the raw skills, languages, and/or certifications extracted from the job description and normalizes them to our standard taxonomy. We suggest showing normalized skills within a user interface so that users see consistent, normalized entities in both the user interface and in the search results. In addition to (or in place of) [Normalize Skills], [Extract Skills] may be useful.

  Users are often interested in finding candidates who hold a specific skill/certification OR a similar skill/certification (e.g., .NET and .NET4). For that reason, our models use skills and certifications to find candidates with similar competencies. Languages only ever function as filters, and certifications can function as filters if certification.required is set to True.

  
  

• Location: Location searching performs a radial search in miles from a job’s location. Searches can include remote candidates when specified by the remote_candidates field. The job’s location is a latitude/longitude centroid value derived (when possible) from the supplied postal_code, or the supplied city, state, and country if no postal_code is supplied. AdeptID will return an HTTP error response if a latitude/longitude cannot be derived from the provided location fields.
• Session and User ID: AdeptID asks for pseudonymized (e.g., hashed) representations of the browser session ID generating the request and the user submitting the request. These enable correlation of searches made by a user, and correlation of sequential updates a user makes to a search, informing improvements to future search results. With pseudonymization, an individual can't be identified (e.g., by name or other identifying information) via the IDs.