Request Body
JobDatarequiredobject
The parsed
JobData from the Sovren Job Order Parser. See Parse a Job OrderIndexIdsToSearchIntorequiredstring[]
The ids of the indexes in which you want to find results (case-insensitive).
Takeoptionalinteger
The number of results to return. No more than 100 records can be returned.
PreferredCategoryWeightsobject
The weights you want to use for scoring. It is important to specify these, otherwise default values will be used.
These weights will be used except in the case that you provided a non-zero weight for a category that is irrelevant in the source document. For example, this can happen when the source document contains no languages.
These weights will be used except in the case that you provided a non-zero weight for a category that is irrelevant in the source document. For example, this can happen when the source document contains no languages.
PreferredCategoryWeights.Educationdecimal
The weight of the Education category relative to other categories.
PreferredCategoryWeights.JobTitlesdecimal
The weight of the JobTitles category relative to other categories..
PreferredCategoryWeights.Skillsdecimal
The weight of the Skills category relative to other categories.
PreferredCategoryWeights.Industriesdecimal
The weight of the Industries/Taxonomies category relative to other categories.
PreferredCategoryWeights.Languagesdecimal
The weight of the Languages category relative to other categories.
PreferredCategoryWeights.Certificationsdecimal
The weight of the Certifications category relative to other categories.
PreferredCategoryWeights.ExecutiveTypedecimal
The weight of the ExecutiveType category relative to other categories.
PreferredCategoryWeights.ManagementLeveldecimal
The weight of the ManagementLevel category relative to other categories..
Settingsoptionalobject
Options to control variations of job titles.
Settings.PositionTitlesMustHaveAnExactMatchoptionalbool
Set to true to turn off variation matches in job titles.
Settings.NormalizeJobTitlesoptionalbool
Normalize the first three job titles specified in FilterCriteria.JobTitles and automatically include them in the query. Additional charges apply.
You will only benefit from using this parameter if the data in your index was parsed with Professions Normalization enabled.
Normalized job titles help identify more matches by looking beyond the exact job title. Normalization uses lists of synonyms behind the scenes. For example, a search for "HR Advisor" will also return results for "Human Resources Consultant".
When matching, the normalized job title is automatically included in the query if the data in your index was parsed with Professions Normalization enabled.
You will only benefit from using this parameter if the data in your index was parsed with Professions Normalization enabled.
Normalized job titles help identify more matches by looking beyond the exact job title. Normalization uses lists of synonyms behind the scenes. For example, a search for "HR Advisor" will also return results for "Human Resources Consultant".
When matching, the normalized job title is automatically included in the query if the data in your index was parsed with Professions Normalization enabled.
Settings.NormalizeJobTitlesLanguageoptionalstring
Specify the language (ISO 639-1 code) of the Job Title to be normalized. This defaults to
en. See list of supported languages.FilterCriteriaoptionalobject
Additional criteria for the result set.
FilterCriteria.RevisionDateRangeoptionalobject
When specified, the revision date of documents must fall within this range.
FilterCriteria.RevisionDateRange.Minimumoptionalstring
The minimum allowed revision date for results in "YYYY-MM-DD" format. Default is 6 months before current date.
FilterCriteria.RevisionDateRange.Maximumoptionalstring
The maximum allowed revision date for results in "YYYY-MM-DD" format. Default is current date.
FilterCriteria.DocumentIdsoptionalstring[]
Results must have one of the specified document ids (case-insensitive).
FilterCriteria.UserDefinedTagsoptionalstring[]
List of user-defined tags. Either all or at least one are required depending on the value of
FilterCriteria.UserDefinedTagsMustAllExist.FilterCriteria.UserDefinedTagsMustAllExistoptionalbool
When true, all of the user-defined tags in FilterCriteria.UserDefinedTags must be found. By default, this is false, which means that at least one of the FilterCriteria.UserDefinedTags must be found.
FilterCriteria.LocationCriteriaoptionalobject[]
Filter results based on location.
FilterCriteria.LocationCriteria.Locationsoptionalobject[]
Results must be found within a certain distance of one of the specified locations.
FilterCriteria.LocationCriteria.Locations[i].CountryCodeoptionalstring
The 2-letter ISO 3166-1 alpha-2 country code for the specified location.
FilterCriteria.LocationCriteria.Locations[i].Regionoptionalstring
The region (i.e. State for U.S. addresses) for the location.
FilterCriteria.LocationCriteria.Locations[i].Municipalityoptionalstring
The municipality (i.e. City for U.S. addresses) for the location.
FilterCriteria.LocationCriteria.Locations[i].PostalCodeoptionalstring
The postal code (or zip code) for the location.
FilterCriteria.LocationCriteria.Locations[i].GeoPointoptionalobject
The geocordinates to be used in the location.
FilterCriteria.LocationCriteria.Locations[i].GeoPoint.Latitudeoptionaldecimal
The latitude coordinate value.
FilterCriteria.LocationCriteria.Locations[i].GeoPoint.Longitudeoptionaldecimal
The longitude coordinate value.
FilterCriteria.LocationCriteria.Distanceoptionalinteger
The distance from Locations within which to find results.
FilterCriteria.LocationCriteria.DistanceUnitoptionalstring
The units for the specified distance. One of:
- Miles
- Kilometers
FilterCriteria.LocationCriteria.GeocodeProvideroptionalstring
The provider to lookup latitude/longitude if they are not specified. One of:
- None
- Bing
FilterCriteria.LocationCriteria.GeocodeProviderKeyoptionalstring
The key for the specified GeocodeProvider. If using Bing you must specify your own provider key.
FilterCriteria.SearchExpressionoptionalstring
Full-text boolean semantic expresion. For full details on the syntax and supported operations refer to the documentation
FilterCriteria.HasPatentsoptionalbool
If true, results must have/require patent experience.
FilterCriteria.HasSecurityCredentialsoptionalbool
If true, results must have/require security credentials. Supports (
*, ?) wildcard characters after the third character in the term as defined in Special Operators.FilterCriteria.SecurityCredentialsoptionalstring[]
Results must have/require at least one of the security credentials specified.
FilterCriteria.IsAuthoroptionalbool
If true, results must have/require experience as an author.
FilterCriteria.IsPublicSpeakeroptionalbool
If true, results must have/require public speaking experience.
FilterCriteria.IsMilitaryoptionalbool
If true, results must have/require military experience.
FilterCriteria.SchoolNamesoptionalstring[]
Results must have at least one of the specified school names. Supports (
*, ?) wildcard characters after the third character in the term as defined in Special OperatorsFilterCriteria.DegreeNamesoptionalstring[]
Results must have at least one of the specified degree names. Supports (
*, ?) wildcard characters after the third character in the term as defined in Special Operators.FilterCriteria.DegreeTypesoptionalstring[]
Results must have at least one of the specified degree types. One of the following explicit values as defined by HROpenStandards.org, in increasing order:
- specialeducation
- someHighSchoolOrEquivalent
- ged
- secondary
- highSchoolOrEquivalent
- certification
- vocational
- someCollege
- HND_HNC_OrEquivalent
- associates
- international
- bachelors
- somePostgraduate
- masters
- intermediategraduate
- professional
- postprofessional
- doctorate
- postdoctorate
FilterCriteria.Employersoptionalstring[]
Results must have at least one of the employers in FilterCriteria.Employers. Supports (
*, ?) wildcard characters after the third character in the term as defined in Special Operators.FilterCriteria.EmployersMustAllBeCurrentEmployeroptionalbool
When true, at least one employer in FilterCriteria.Employers must be found in the current time frame.
FilterCriteria.MonthsExperienceoptionalobject
When specified, results total work experieince must fall within this range.
FilterCriteria.MonthsExperience.Minimumoptionalinteger
Results must have/require at least the amount of total work experience specified.
FilterCriteria.MonthsExperience.Maximumoptionalinteger
Results must have/require at MOST the amount of total work experience specified.
FilterCriteria.DocumentLanguagesoptionalstring[]
Results must be written in one of the specified languages.
FilterCriteria.Skillsoptionalobject[]
Results must have/require at least one of the specified skills.
FilterCriteria.Skills[i].SkillNameoptionalstring
The name of the skill. Supports (
*, ?) wildcard characters after the third character in the term as defined in Special Operators.FilterCriteria.Skills[i].ExperienceLeveloptionalstring
The experience level of the skill. Supports the following values:
Low(0-3 years)Mid(4-6 years)High(7+ years)
FilterCriteria.Skills[i].IsCurrentoptionalbool
The skill must be a current skill.
FilterCriteria.SkillsMustAllExistoptionalbool
When true, all of the skills in FilterCriteria.Skills must be found. By default, this is false, which means that at least one of the FilterCriteria.Skills must be found.
FilterCriteria.IsTopStudentoptionalbool
Results must have an education with a normalized gpa of .75 or higher (for example, 3.0/4.0 or higher).
FilterCriteria.IsCurrentStudentoptionalbool
Results must have a current education.
FilterCriteria.IsRecentGraduateoptionalbool
Results must have graduated within the last 18 months
FilterCriteria.JobTitlesoptionalobject[]
Results must have at least one of the specified job titles.
FilterCriteria.JobTitles[i].Titleoptionalstring
The name of the Job Title. Supports (
*, ?) wildcard characters after the third character in the term as defined in Special Operators.FilterCriteria.JobTitles[i].IsCurrentoptionalbool
The job title must be a current job title.
FilterCriteria.ExecutiveTypeoptionalstring[]
Results must have at least one of the following types of executive:
- None
- Executive
- Admin
- Accounting
- Operations
- Financial
- Marketing
- Business_Dev
- IT
- General
- Learning
FilterCriteria.Certificationsoptionalstring[]
Results must have at least one of the specified certifications. Supports (
*, ?) wildcard characters after the third character in the term as defined in Special Operators.FilterCriteria.MonthsManagementExperienceoptionalobject
Results must have the management experience specified in this months range.
FilterCriteria.MonthsManagementExperience.Minimumoptionalinteger
Lower bound of the management experience range.
FilterCriteria.MonthsManagementExperience.Maximumoptionalinteger
Upper bound of the management experience range.
FilterCriteria.CurrentManagementLeveloptionalstring
Results must currently have at least one of the following management levels:
- None
- Low
- Mid
- High
FilterCriteria.LanguagesKnownoptionalstring[]
List of ISO 639-1 language codes (lower case, two letters) representing languages known. Either all or at least one are required depending on the value of FilterCriteria.LanguagesKnownMustAllExist.
FilterCriteria.LanguagesKnownMustAllExistoptionalbool
When true, all of the languages in FilterCriteria.LanguagesKnown must be found. By default, this is false, which means that at least one of the FilterCriteria.LanguagesKnown must be found.
FilterCriteria.Taxonomiesoptionalstring[]
Results must contain at least one of the specified best-fit taxonomy IDs or best-fit subtaxonomy IDs. A list of our built-in taxonomy IDs can be found here.
FilterCriteria.AverageMonthsPerEmployeroptionalobject
Results must have an average months per employers specified in this range. Only applicable for resumes; setting this when filtering jobs will cause an error.
FilterCriteria.AverageMonthsPerEmployer.Minimumoptionalinteger
Lower bound of the average months per employer range.
FilterCriteria.AverageMonthsPerEmployer.Maximumoptionalinteger
Upper bound of the average months per employer range.
FilterCriteria.JobPredictiveIndexoptionalobject
Results must have a job predictive index specified in this range. Only applicable for resumes; setting this when filtering jobs will cause an error.
FilterCriteria.JobPredictiveIndex.Minimumoptionalinteger
Lower bound of the job predictive index range.
FilterCriteria.JobPredictiveIndex.Maximumoptionalinteger
Upper bound of the job predictive index range.