The parsed JobData from the Sovren Job Order Parser. See Parse a Job Order
Provideroptionalstring
The Provider you wish to use to geocode the postal address (current options are "Google" or "Bing"). If not specified, we will default to Google. If passing a ProviderKey, this field is required.
ProviderKeyoptionalstring
The Provider Key for the specified Provider. If using Bing you must specify your own provider key.
PostalAddressoptionalobject
The postal address you wish to geocode. For best results, specify as many of the PostalAddress fields as possible. If provided, this address will be used to get the geocode coordinates instead of the address included in the ParsedDocument (if present), however, the address in the ParsedDocument will not be modified.
Information explaining the outcome of the transaction.
Info.Codestring
A response code elaborating on the HTTP status code. The following is a list of codes that can be returned by the service:
Success– Successful transaction
MissingParameter- A required parameter wasn't provided
InvalidParameter- A parameter was incorrectly specified
AuthenticationError- An error occurred with the credentials provided
InsufficientData- The address provided doesn't have enough granularity to be geocoded effectively
CoordinatesNotFound- The geocoding provider couldn't find any coordinates matching the provided address
Info.Messagestring
This message further describes the code providing additional detail.
Info.TransactionIdstring
The (GUID) id for a specific API transaction. Use this when contacting support@sovren.com about issues.
Info.EngineVersionstring
The version of the parsing/matching engine running under-the-hood.
Info.ApiVersionstring
The version of the API.
Info.TotalElapsedMillisecondsinteger
How long the transaction took on Sovren's server, in milliseconds. If the transaction takes longer to complete on the client side, that extra duration is solely network latency.
Info.TransactionCostdecimal
How many credits the transaction costs.How many credits the transaction costs.
Info.CustomerDetailsobject
Information about the customer who made the API call.
Value.CustomerDetails.AccountIdstring
The AccountId for the account.
Value.CustomerDetails.Namestring
The customer name on the account.
Value.CustomerDetails.IPAddressstring
The client IP Address where the API call originated.
Value.CustomerDetails.Regionstring
The region for the account, also known as the 'Data Center'.
Value.CustomerDetails.CreditsRemainingdecimal
The number of credits remaining to be used by the account.
The number of requests that can be made at one time. If using sub-accounts, this is the maximum number of concurent requests across all accounts, not just this single sub-account.
Value.CustomerDetails.ExpirationDatedate
The date that the current credits expire.
Valueobject
Contains response data for the transaction.
Value.JobDataoptionalobject
The main output from the Sovren Job Parser containing the geocoded coordinates.
Value.JobData.CurrentJobIsManagementbool
Whether or not the job is a management position. Used by Sovren for AI Matching.
Value.JobData.HighestManagementScoreobject
The management score, or null. Used by Sovren for AI Matching.
Value.JobData.HighestManagementScore.Valueinteger
The management score.
Value.JobData.ManagementLevelstring
The management level. Used by Sovren for AI Matching. One of:
None
Low
Mid
High
Value.JobData.ExecutiveTypestring
What kind of executive position the job is, if any. Used by Sovren for AI Matching. One of:
NONE
ADMIN
ACCOUNTING
BUSINESS_DEV
EXECUTIVE
FINANCIAL
GENERAL
IT
LEARNING
MARKETING
OPERATIONS
Value.JobData.MinimumYearsobject
The minimum years experience for the job, or null. Used by Sovren for AI Matching.
Value.JobData.MinimumYears.Valueinteger
The minimum years experience for the job.
Value.JobData.MaximumYearsobject
The maximum years experience for the job, or null. Used by Sovren for AI Matching.
Value.JobData.MaximumYears.Valueinteger
The maximum years experience for the job.
Value.JobData.MinimumYearsManagementobject
The minimum years of management experience, or null. Used by Sovren for AI Matching.
Value.JobData.MinimumYearsManagement.Valueinteger
The minimum years of management experience.
Value.JobData.MaximumYearsManagementobject
The maximum years of management experience, or null. Used by Sovren for AI Matching.
Value.JobData.MaximumYearsManagement.Valueinteger
The maximum years of management experience.
Value.JobData.RequiredDegreestring
The required educational degree, if listed. Used by Sovren for AI Matching.
Value.JobData.JobDescriptionstring
Section containing information about the job. Job description strictly includes duties, tasks, and responsibilities for the role with as little irrelevant text as possible.
Value.JobData.JobRequirementsstring
Full text of any requirements listed by the job.
Value.JobData.Benefitsstring
Full text of any benefits listed by the job.
Value.JobData.EmployerDescriptionstring
Full text of any employer description listed by the job.
Value.JobData.StartDateobject
The start date of the job.
Value.JobData.StartDate.Valuedate
The value of the start date of the job.
Value.JobData.JobTitlesobject
The job titles found in the job. Used by Sovren for AI Matching.
Any reference number found for the job application.
Value.JobData.Salaryobject
The salary found for the position If no lexical cues are available from the vacancy, the time scale is guessed based on predefined salary ranges. Here are some rough salary ranges (note: country-specific conditions may apply):
1 or 2 digits salary (9, 12): hourly
3 or 4 digits salary (3800, 5000): monthly
5 digit salary (38000, 50000): yearly
If a monthly salary is extracted, to get the annual salary it is multiplied by 14 (if country = AT) or 12 (all other countries).
Value.JobData.Salary.Minimumobject
The normalized minimum yearly salary.
Value.JobData.Salary.MinimumValueinteger
The value of the normalized minimum yearly salary.
Value.JobData.Salary.Maximumobject
The normalized maximum yearly salary.
Value.JobData.Salary.MaximumValueinteger
The value of the normalized maximum yearly salary.
Value.JobData.Salary.RawMinimumstring
The raw, un-normalized, minimum value. This is returned as is in the text, so there is no guarantee that it will evaluate to a valid number and not a string.
Value.JobData.Salary.RawMaximumstring
The raw, un-normalized, maximum value. This is returned as is in the text, so there is no guarantee that it will evaluate to a valid number and not a string.
Value.JobData.Salary.Currencystring
Currency code (ISO 4217) applied to the Minimum and Maximum
Value.JobData.MinimumWorkingHoursobject
The minimum number of working hours per week, or null.
Value.JobData.MinimumWorkingHours.Valueinteger
The minimum number of working hours per week.
Value.JobData.MaximumWorkingHoursobject
The maximum number of working hours per week, or null.
Value.JobData.MaximumWorkingHours.Valueinteger
The maximum number of working hours per week.
Value.JobData.WorkingHoursstring
The type of working hours. One of:
regular
irregular
Value.JobData.IsRemotebool
Whether or not the position is remote. Includes fulltime, partial and temporary remote working opportunities.
Value.JobData.DriversLicensesstring[]
Any drivers license requirements.
Value.JobData.EmploymentTypestring
The type of employment. One of:
unspecified
fulltime
parttime
fulltime/parttime
Value.JobData.ContractTypestring
The contract type. One of:
unspecified
permanent
temporary
possibly_permanent
interim
franchise
side
internship
voluntary
freelance
apprenticeship
assisted
Value.JobData.TermsOfIntereststring[]
Terms of interest listed in the job.
Value.JobData.Ownersstring[]
Any owners of the job posting, if listed.
Value.JobData.SkillsDataobject[]
Deprecated. Use v2 skills taxonomy and its associated Skills output.
Value.JobData.SkillsData[i].Rootstring
The name of the skills list that these taxonomies belong to.