Skip to content
CV/Resume and Job Parser Documentation
Job Parsing
latest

Job parsing data model🔗

This page describes all the fields returned by the Textkernel parser product for job parsing.

Document Information🔗

Job Text Language string

The language of the job description, as detected by the parsing models.

  • XML path: //JobInfo/@lang
  • JSON path: $.lang
Filename string

The name of the parsed binary document, if provided as input to the parsing endpoint, null otherwise.

  • XML path: //JobInfo/@file
  • JSON path: $.file
Document Last Modified Date date

The last date/time the binary document was edited, if the binary document contains that metadata information.

  • XML path: //JobInfo/@lastmodified
  • JSON path: $.lastModified
Example JSON/XML 
{
    "lang": "english",
    "file": "job.pdf",
    "lastModified": "2023-01-01"
}

<JobInfo lang="english" file="job.pdf"
        lastModified="2023-01-01">

Job Overview🔗

Job Title string

The job title of the vacancy.

  • XML path: //JobOverview/Job/JobTitle
  • JSON path: $.jobOverview.job.jobTitle
Textkernel Profession Code string, string Add-on required

The profession derived from the job title of the vacancy, and normalized to the Textkernel Professions Taxonomy.

Note: This field requires the Profession Classification add-on.

  • XML path:
    • //JobOverview/Job/ProfessionCode
    • //JobOverview/Job/ProfessionDescription
  • JSON path:
    • $.jobOverview.job.professionCode
    • $.jobOverview.job.professionDescription
Textkernel Profession Group string, string Add-on required

The profession group derived from the job title of the vacancy, and normalized to the Textkernel Professions Taxonomy.

Note: This field requires the Profession Classification add-on.

  • XML path:
    • //JobOverview/Job/ProfessionGroupCode
    • //JobOverview/Job/ProfessionGroupDescription
  • JSON path:
    • $.jobOverview.job.professionGroupCode
    • $.jobOverview.job.professionGroupDescription
Textkernel Profession Class string, string Add-on required

The profession class derived from the job title of the vacancy, and normalized to the Textkernel Professions Taxonomy.

Note: This field requires the Profession Classification add-on.

  • XML path:
    • //JobOverview/Job/ProfessionClassCode
    • //JobOverview/Job/ProfessionClassDescription
  • JSON path:
    • $.jobOverview.job.professionClassCode
    • $.jobOverview.job.professionClassDescription
ONET 2010 Profession string, string Add-on required

The job title of the vacancy normalized to the ONET 2010 classification. Please note that this classification is deprecated in favor of ONET 2019, and will be removed in September 2024.

Note: This field requires the Profession Classification add-on.

  • XML path:
    • //JobOverview/Job/ONET2010Code
    • //JobOverview/Job/ONET2010Description
  • JSON path:
    • $.jobOverview.job.oNET2010Code
    • $.jobOverview.job.oNET2010Description
ONET 2019 Profession string Add-on required

The job title of the vacancy normalized to the ONET 2019 classification.

Note: This field requires the Profession Classification add-on.

  • XML path: //JobOverview/Job/ONET2019Code
  • JSON path: $.jobOverview.job.oNET2019Code
KLDB 2020 Profession string Add-on required

The job title of the vacancy normalized to the KLDB 2020 classification.

Note: This field requires the Profession Classification add-on.

  • XML path: //JobOverview/Job/KLDB2020Code
  • JSON path: $.jobOverview.job.kLDB2020Code
ISCO 2008 Profession string, string Add-on required

The job title of the vacancy normalized to the ISCO 2008 classification.

Note: This field requires the Profession Classification add-on.

  • XML path:
    • //JobOverview/Job/ISCO2008Code
    • //JobOverview/Job/ISCO2008Description
  • JSON path:
    • $.jobOverview.job.iSCO2008Code
    • $.jobOverview.job.iSCO2008Description
Work Field string, string Add-on required

The work field of the vacancy, calculated based on job title and normalized to the Textkernel Professions Taxonomy.

Note: This field requires the Profession Classification add-on.

  • XML path:
    • //JobOverview/Job/WorkField/WorkFieldCode
    • //JobOverview/Job/WorkField/WorkFieldDescription
  • JSON path:
    • $.jobOverview.job.workField.workFieldCode
    • $.jobOverview.job.workField.workFieldDescription
Work Field Experience Level string, string Add-on required

The experience level required in the work field by the vacancy, normalized to the Textkernel Experience Level classification.

Note: This field requires the Profession Classification add-on.

  • XML path:
    • //JobOverview/Job/WorkField/ExperienceLevelCode
    • //JobOverview/Job/WorkField/ExperienceLevelDescription
  • JSON path:
    • $.jobOverview.job.workField.experienceLevelCode
    • $.jobOverview.job.workField.experienceLevelDescription
Job Description string

A section of the vacancy containing information about the job. The job description strictly includes duties, tasks, and responsibilities for the role with as little irrelevant text as possible.

  • XML path: //JobOverview/Job/JobDescription
  • JSON path: $.jobOverview.job.jobDescription
Job Summary string

A section of the vacancy containing its summary. It usually consists of a table with the main information about the position.

  • XML path: //JobOverview/Job/Summary
  • JSON path: $.jobOverview.job.summary
Example JSON/XML 
{
    "jobOverview": {
        "job": {
            "jobTitle": "Java Software Engineer",
            "professionCode": "696",
            "professionDescription": "Java Developer",
            "professionGroupCode": "82",
            "professionGroupDescription": "Programmers",
            "professionClassCode": "9",
            "professionClassDescription": "Information and Communication Technology",
            "oNET2010Code": "15_1131_00",
            "oNET2010Description": "Computer Programmers",
            "oNET2019Code": "15-1251.00",
            "kLDB2020Code": "43414",
            "iSCO2008Code": "2512",
            "iSCO2008Description": "Software developers",
            "workField": {
                "workFieldCode": "82",
                "workFieldDescription": "Programmers",
                "experienceLevelCode": "VAC_2_EXPERIENCED",
                "experienceLevelDescription": "Experienced"
            },
            "jobDescription": "...",
            "summary": "..."
        }
    }
}

<JobInfo>
    <JobOverview>
        <Job>
            <JobTitle>Java Software Engineer</JobTitle>
            <ProfessionCode>696</ProfessionCode>
            <ProfessionDescription>Java Developer</ProfessionDescription>
            <ProfessionGroupCode>82</ProfessionGroupCode>
            <ProfessionGroupDescription>Programmers</ProfessionGroupDescription>
            <ProfessionClassCode>9</ProfessionClassCode>
            <ProfessionClassDescription>Information and Communication Technology</ProfessionClassDescription>
            <ONET2010Code>15_1131_00</ONET2010Code>
            <ONET2010Description>Computer Programmers</ONET2010Description>
            <ONET2019Code>15-1251.00</ONET2019Code>
            <KLDB2020Code>43414</KLDB2020Code>
            <ISCO2008Code>2512</ISCO2008Code>
            <ISCO2008Description>Software developers</ISCO2008Description>
            <WorkField>
                <WorkFieldCode>82</WorkFieldCode>
                <WorkFieldDescription>Programmers</WorkFieldDescription>
                <ExperienceLevelCode>VAC_2_EXPERIENCED</ExperienceLevelCode>
                <ExperienceLevelDescription>Experienced</ExperienceLevelDescription>
            </WorkField>
            <JobDescription>...</JobDescription>
            <Summary>...</Summary>
        </Job>
    </JobOverview>
<JobInfo>

Job Location🔗

Geo coordinates coordinates Add-on required

The geo coordinates of the workplace, in decimal degrees format.

Note: This field requires the Geocoding add-on.

  • XML path:
    • //JobOverview/Job/Location/Latitude
    • //JobOverview/Job/Location/Longitude
  • JSON path:
    • $.jobOverview.job.location.latitude
    • $.jobOverview.job.location.longitude
Postal Code string

The postal code of the workplace.

  • XML path: //JobOverview/Job/Location/PostalCode
  • JSON path: $.jobOverview.job.location.postalCode
City string

The city of the workplace.

  • XML path: //JobOverview/Job/Location/City
  • JSON path: $.jobOverview.job.location.city
Subregion string, string

The subregion of the workplace, normalized to the ISO 3166-2 subregion classification (if application to the country).

  • XML path:
    • //JobOverview/Job/Location/SubRegionCode
    • //JobOverview/Job/Location/SubRegionDescription
  • JSON path:
    • $.jobOverview.job.location.subRegionCode
    • $.jobOverview.job.location.subRegionDescription
Region / State string, string

The region or state of the workplace, normalized to the ISO 3166-2 region classification.

  • XML path:
    • //JobOverview/Job/Location/RegionCode
    • //JobOverview/Job/Location/RegionDescription
  • JSON path:
    • $.jobOverview.job.location.regionCode
    • $.jobOverview.job.location.regionDescription
Country string, string

The country of the workplace, normalized to the ISO 3166-1 alpha-2 classification.

  • XML path:
    • //JobOverview/Job/Location/CountryCode
    • //JobOverview/Job/Location/CountryDescription
  • JSON path:
    • $.jobOverview.job.location.countryCode
    • $.jobOverview.job.location.countryDescription
Remote string

Indicates whether remote work is supported by the position or not. Returned values are yes or no. Includes fulltime, partial and temporary remote working opportunities.

  • XML path: //JobOverview/Job/Location/Remote
  • JSON path: $.jobOverview.job.location.remote
Example JSON/XML 
{
    "jobOverview": {
        "job": {
            "location": {
                "latitude": "52.3783909",
                "longitude": "4.8986248",
                "postalCode": "1012 AB",
                "city": "Amsterdam",
                "subRegionCode": "",
                "subRegionDescription": "",
                "regionCode": "NL-NH",
                "regionDescription": "NL North-Holland",
                "countryCode": "NL",
                "countryDescription": "Netherlands",
                "remote": "no"
            }
        }
    }
}

<JobInfo>
    <JobOverview>
        <Job>
            <Location>
                <Latitude>52.3783909</Latitude>
                <Longitude>4.8986248</Longitude>
                <PostalCode>1012 AB</PostalCode>
                <City>Amsterdam</City>
                <SubRegionCode></SubRegionCode>
                <SubRegionDescription></SubRegionDescription>
                <RegionCode>NL-NH</RegionCode>
                <RegionDescription>NL North-Holland</RegionDescription>
                <CountryCode>NL</CountryCode>
                <CountryDescription>Netherlands</CountryDescription>
                <Remote>no</Remote>
            </Location>
        </Job>
</JobInfo>

Organization🔗

Organization Name string

The name of the organization offering the position.

  • XML path: //JobOverview/Organization/Name
  • JSON path: $.jobOverview.organization.name
Contact Person string

The full name of the contact person from the organization. It can contain multiple values concatenated by comma.

  • XML path: //JobOverview/Organization/ContactPerson
  • JSON path: $.jobOverview.organization.contactPerson
Organization Phone string

The phone of the organization with the international calling prefix. It can contain multiple values concatenated by comma.

  • XML path: //JobOverview/Organization/Phone
  • JSON path: $.jobOverview.organization.phone
Organization Email string

The email address of the organization. It can contain multiple values concatenated by comma.

  • XML path: //JobOverview/Organization/Email
  • JSON path: $.jobOverview.organization.email
Organization Website string

The validated and normalized website of the organization. It can contain multiple values concatenated by comma.

  • XML path: //JobOverview/Organization/Website
  • JSON path: $.jobOverview.organization.website
Advertiser Type string, string

Information about the provenience of the vacancy (0 for direct employer or 1 for staffing agency).

  • XML path:
    • //JobOverview/Organization/AdvertiserTypeCode
    • //JobOverview/Organization/AdvertiserTypeDescription
  • JSON path:
    • $.jobOverview.organization.advertiserTypeCode
    • $.jobOverview.organization.advertiserTypeDescription
Organization Description string

A section of the vacancy containing information about the organization.

  • XML path: //JobOverview/OrganizationDescription
  • JSON path: $.jobOverview.organization.organizationDescription
Organization Postal Code string

The postal code where the organization is located.

  • XML path: //JobOverview/Organization/Location/PostalCode
  • JSON path: $.jobOverview.organization.location.postalCode
Organization City string

The city where the organization is located.

  • XML path: //JobOverview/Organization/Location/City
  • JSON path: $.jobOverview.organization.location.city
Organization Region string, string

The region where the organization is located, normalized to the ISO 3166-2 region classification.

  • XML path:
    • //JobOverview/Organization/Location/RegionCode
    • //JobOverview/Organization/Location/RegionDescription
  • JSON path:
    • $.jobOverview.organization.location.regionCode
    • $.jobOverview.organization.location.regionDescription
Organization Country string, string

The country where the organization is located, normalized to the ISO 3166-1 alpha-2 classification.

  • XML path:
    • //JobOverview/Organization/Location/CountryCode
    • //JobOverview/Organization/Location/CountryDescription
  • JSON path:
    • $.jobOverview.organization.location.countryCode
    • $.jobOverview.organization.location.countryDescription
Organization Postbox Number string

The postbox number of the company. Please note that this field is deprecated.

  • XML path: //JobOverview/Organization/Location/PostboxNumber
  • JSON path: $.jobOverview.organization.location.postboxNumber
Organization Postbox Postal Code string

The postbox postal code of the company. Please note that this field is deprecated.

  • XML path: //JobOverview/Organization/Location/PostboxPostalCode
  • JSON path: $.jobOverview.organization.location.postboxPostalCode
Organization Postbox City string

The postbox city of the company. Please note that this field is deprecated.

  • XML path: //JobOverview/Organization/Location/PostboxCity
  • JSON path: $.jobOverview.organization.location.postboxCity
Example JSON/XML 
{
    "organization": {
        "name": "Textkernel BV",
        "contactPerson": "John Doe",
        "phone": "+31204942496",
        "email": "info@textkernel.com",
        "website": "www.textkernel.com",
        "advertiserTypeCode": "1",
        "advertiserTypeDescription": "Direct Employer",
        "organizationDescription": "Textkernel is widely regarded as the international leader...",
        "location": {
            "postalCode": "1031 HL",
            "city": "Amsterdam",
            "postboxNumber": "15D",
            "postboxPostalCode": "1031 HL",
            "postboxCity": "Amsterdam",
            "regionCode": "NL-NH",
            "regionDescription": "NL North-Holland",
            "countryCode": "NL",
            "countryDescription": "Netherlands"
        }
    }
}

<JobInfo>
    <JobOverview>
        <Organization>
            <Name>Textkernel BV</Name>
            <ContactPerson>John Doe</ContactPerson>
            <Phone>+31204942496</Phone>
            <Email>info@textkernel.com</Email>
            <Website>www.textkernel.com</Website>
            <AdvertiserTypeCode>1</AdvertiserTypeCode>
            <AdvertiserTypeDescription>Direct Employer</AdvertiserTypeDescription>
            <OrganizationDescription>Textkernel is widely regarded as the international leader...</OrganizationDescription>
            <Location>
                <PostalCode>1031 HL</PostalCode>
                <City>Amsterdam</City>
                <PostboxNumber>15D</PostboxNumber>
                <PostboxPostalCode>1031 HL</PostboxPostalCode>
                <PostboxCity>Amsterdam</PostboxCity>
                <RegionCode>NL-NH</RegionCode>
                <RegionDescription>NL North-Holland</RegionDescription>
                <CountryCode>NL</CountryCode>
                <CountryDescription>Netherlands</CountryDescription>
            </Location>
        </Organization>
    </JobOverview>
</JobInfo>

Candidate Requirements🔗

Education Level Required - Local string, string

The education level required by the vacancy, normalized to the Textkernel Local Education Level classification.

  • XML path:
    • //JobDetails/Profile/Education/LocalCode
    • //JobDetails/Profile/Education/LocalDescription
  • JSON path:
    • $.jobDetails.profile.education.localCode
    • $.jobDetails.profile.education.localDescription
Education Level Required - International string, string

The education level required by the vacancy, normalized to the Textkernel International Education Level classification.

  • XML path:
    • //JobDetails/Profile/Education/InternationalCode
    • //JobDetails/Profile/Education/InternationalDescription
  • JSON path:
    • $.jobDetails.profile.education.internationalCode
    • $.jobDetails.profile.education.internationalDescription
Education Description string

The education level string, as extracted from the vacancy text and not normalized.

  • XML path: //JobDetails/Profile/Education/Description
  • JSON path: $.jobDetails.profile.education.description
Driver's License Requirement string

The driver license required by the vacancy, as extracted from the vacancy text.

  • XML path: //JobDetails/Profile/DriversLicenses/DriversLicense
  • JSON path: $.jobDetails.profile.driversLicenses.driversLicense
Candidate Profile Description string

A section of the vacancy containing information about the candidate requirements. The candidate description usually covers personal qualifications, skills and other competences that are expected from the candidate in order to do the job described in the vacancy.

  • XML path: //JobDetails/Profile/CandidateDescription
  • JSON path: $.jobDetails.profile.candidateDescription
Min Required Years Of Experience numeric

The minimum years of experience required by the vacancy, if mentioned in vacancy text.

  • XML path: //JobDetails/Profile/YearsOfExperience/Minimum
  • JSON path: $.jobDetails.profile.yearsOfExperience.minimum
Max Required Years Of Experience numeric

The maximum years of experience required by the vacancy, if mentioned in vacancy text.

  • XML path: //JobDetails/Profile/YearsOfExperience/Maximum
  • JSON path: $.jobDetails.profile.yearsOfExperience.maximum
Example JSON/XML 
{
    "jobDetails": {
        "profile": {
            "education": {
                "localCode": "NL_11",
                "localDescription": "HBO",
                "internationalCode": "3",
                "internationalDescription": "Bachelor",
                "description": "HBO degree or higher"
            },
            "driversLicenses": [
                {
                    "driversLicense": "car driver license"
                }
            ],
            "candidateDescription": "5+ years of pre-sales, account management or...",
            "yearsOfExperience": {
                "minimum": "5",
                "maximum": ""
            }
        }
    }
}

<JobInfo>
    <JobDetails>
        <Profile>
            <Education>
                <LocalCode>NL_11</LocalCode>
                <LocalDescription>HBO</LocalDescription>
                <InternationalCode>3</InternationalCode>
                <InternationalDescription>Bachelor</InternationalDescription>
                <Description>HBO degree or higher</Description>
            </Education>
            <DriverLicenses>
                <DriversLicense>car driver license</DriversLicense>
            </DriverLicenses>
            <CandidateDescription>5+ years of pre-sales, account management or...</CandidateDescription>
            <YearsOfExperience>
                <Minimum>5</Minimum>
                <Maximum></Maximum>
            </YearsOfExperience>
        </Profile>
    </JobDetails>
</JobInfo>

Job Conditions🔗

Min Working Hours per Week numeric

The minimum working hours per week, if mentioned in vacancy text.

  • XML path: //JobDetails/Conditions/WorkingHoursPerWeek/Minimum
  • JSON path: $.jobDetails.conditions.workingHoursPerWeek.minimum
Max Working Hours per Week numeric

The maximum working hours per week, if mentioned in vacancy text.

  • XML path: //JobDetails/Conditions/WorkingHoursPerWeek/Maximum
  • JSON path: $.jobDetails.conditions.workingHoursPerWeek.maximum
Type of Working Hours string, string

The working hours schedule offered by the vacancy, normalized to 1 for regular hours or 2 for irregular hours (anything outside the range 8:00AM - 6:00PM).

  • XML path:
    • //JobDetails/Conditions/WorkingHoursCode
    • //JobDetails/Conditions/WorkingHoursDescription
  • JSON path:
    • $.jobDetails.conditions.workingHoursCode
    • $.jobDetails.conditions.workingHoursDescription
Part time vs Full time string, string

The employment type offered by the vacancy, normalized to 1 for full-time positions, 2 for part-time positions and 3 for vacancy not specifying the employment type.

  • XML path:
    • //JobDetails/Conditions/ParttimeFulltimeCode
    • //JobDetails/Conditions/ParttimeFulltimeDescription
  • JSON path:
    • $.jobDetails.conditions.parttimeFulltimeCode
    • $.jobDetails.conditions.parttimeFulltimeDescription
Contract Type string, string

The type of contract offered by the vacancy, normalized to the Textkernel Contract Type classification.

  • XML path:
    • //JobDetails/Conditions/ContractTypeCode
    • //JobDetails/Conditions/ContractTypeDescription
  • JSON path:
    • $.jobDetails.conditions.contractTypeCode
    • $.jobDetails.conditions.contractTypeDescription
Job Conditions Description string

A section of the vacancy containing information about the benefits and conditions offered with the position.

  • XML path: //JobDetails/Conditions/ConditionsDescription
  • JSON path: $.jobDetails.conditions.conditionsDescription
Min Yearly Salary numeric

The minimum yearly salary, if mentioned in vacancy text.

This field is calculated from the minimumAsExtracted field, based on the assumption that the job is for 8 hours per day, 5 days per week, 12 months per year.

  • XML path: //JobDetails/Conditions/Salary/Minimum
  • JSON path: $.jobDetails.conditions.salary.minimum
Max Yearly Salary numeric

The maximum yearly salary, if mentioned in vacancy text.

This field is calculated from the maximumAsExtracted field, based on the assumption that the job is for 8 hours per day, 5 days per week, 12 months per year.

  • XML path: //JobDetails/Conditions/Salary/Maximum
  • JSON path: $.jobDetails.conditions.salary.maximum
Salary Currency string

The currency of the yearly salaries, normalized to the ISO 4217 classification.

  • XML path: //JobDetails/Conditions/Salary/CurrencyCode
  • JSON path: $.jobDetails.conditions.salary.currencyCode
Min Salary as Extracted string

The minimum salary as extracted from the vacancy text.

  • XML path: //JobDetails/Conditions/Salary/MinimumAsExtracted
  • JSON path: $.jobDetails.conditions.salary.minimumAsExtracted
Max Salary as Extracted string

The maximum salary as extracted from the vacancy text.

  • XML path: //JobDetails/Conditions/Salary/MaximumAsExtracted
  • JSON path: $.jobDetails.conditions.salary.maximumAsExtracted
Salary Timescale as Extracted code

The timescale of the salary as extracted from the vacancy text. The possible values are: - H: Hourly - J: Daily - W: Weekly - M: Monthly - A: Annual

  • XML path: //JobDetails/Conditions/Salary/TimescaleAsExtracted
  • JSON path: $.jobDetails.conditions.salary.timescaleAsExtracted
Example JSON/XML 
{
    "jobDetails": {
        "conditions": {
            "workingHoursPerWeek": {
                "minimum": "32",
                "maximum": "40"
            },
            "workingHoursCode": "1",
            "workingHoursDescription": "Regular working hours",
            "parttimeFulltimeCode": "1",
            "parttimeFulltimeDescription": "Full-time",
            "contractTypeCode": "1",
            "contractTypeDescription": "Permanent contract",
            "conditionsDescription": "What we offer: A fast-growing company with...",
            "salary": {
                "minimum": "30600",
                "maximum": "36000",
                "currencyCode": "EUR",
                "minimumAsExtracted": "2550",
                "maximumAsExtracted": "3000",
                "timescaleAsExtracted": "M"
            }
        }
    }
}

<JobInfo>
    <JobDetails>
        <Conditions>
            <WorkingHoursPerWeek>
                <Minimum>32</Minimum>
                <Maximum>40</Maximum>
            </WorkingHoursPerWeek>
            <WorkingHoursCode>1</WorkingHoursCode>
            <WorkingHoursDescription>Regular working hours</WorkingHoursDescription>
            <ParttimeFulltimeCode>1</ParttimeFulltimeCode>
            <ParttimeFulltimeDescription>Full-time</ParttimeFulltimeDescription>
            <ContractTypeCode>1</ContractTypeCode>
            <ContractTypeDescription>Permanent contract</ContractTypeDescription>
            <ConditionsDescription>What we offer: A fast-growing company with...</ConditionsDescription>
            <Salary>
                <Minimum>30600</Minimum>
                <Maximum>36000</Maximum>
                <CurrencyCode>EUR</CurrencyCode>
                <MinimumAsExtracted>2550</MinimumAsExtracted>
                <MaximumAsExtracted>3000</MaximumAsExtracted>
                <TimescaleAsExtracted>M</TimescaleAsExtracted>
            </Salary>
        </Conditions>
    </JobDetails>
</JobInfo>

Application Details🔗

Job URL string

The URL of the vacancy if found online.

  • XML path: //ApplicationDetails/VacancyUrl
  • JSON path: $.applicationDetails.vacancyUrl
Job Post Date date

The date when vacancy was posted online, in the format YYYY-MM-DD.

  • XML path: //ApplicationDetails/PostDate
  • JSON path: $.applicationDetails.postDate
Application Deadline date

The deadline to apply for the position, in the format YYYY-MM-DD.

  • XML path: //ApplicationDetails/ApplyBeforeDate
  • JSON path: $.applicationDetails.applyBeforeDate
Job Start Date date

The start date of the job, in the format YYYY-MM-DD.

  • XML path: //ApplicationDetails/StartDate
  • JSON path: $.applicationDetails.startDate
Reference Number string

The reference number of the vacancy, usually assigned when posting the vacancy online.

  • XML path: //ApplicationDetails/ReferenceNumber
  • JSON path: $.applicationDetails.referenceNumber
Application Description string

A section of the vacancy containing information about the application process.

  • XML path: //ApplicationDetails/ApplicationDescription
  • JSON path: $.applicationDetails.applicationDescription
Example JSON/XML 
{
    "applicationDetails": {
        "vacancyUrl": "https://textkernel.careers/o/presales-solution-consultant-nl",
        "postDate": "2023-07-01",
        "applyBeforeDate": "2023-08-31",
        "startDate": "2023-10-01",
        "referenceNumber": "REFNO-2023-0801",
        "applicationDescription": "..."
    }
}

<JobInfo>
    <ApplicationDetails>
        <VacancyUrl>https://textkernel.careers/o/presales-solution-consultant-nl</VacancyUrl>
        <PostDate>2023-07-01</PostDate>
        <ApplyBeforeDate>2023-08-31</ApplyBeforeDate>
        <StartDate>2023-10-01</StartDate>
        <ReferenceNumber>REFNO-2023-0801</ReferenceNumber>
        <ApplicationDescription>...</ApplicationDescription>
    </ApplicationDetails>
</JobInfo>

Additional Information🔗

Language Skills object[]

The list of language skills required by the position, normalized to the ISO 639-1 classification. As opposed to the other skill types, normalized values for language skills do not require an add-on.

  • XML path:
    • //Skills/LanguageSkills[]/LanguageSkill/SkillCode (type string)
    • //Skills/LanguageSkills[]/LanguageSkill/SkillDescription (type string)
  • JSON path:
    • $.skills.languageSkills[].skillCode
    • $.skills.languageSkills[].skillDescription
IT Skills object[] Add-on required for some fields

The list of IT skills required by the position, as extracted from the vacancy text (field Skill).

Additionally, the list of the extracted IT skills normalized to the Textkernel Skills Taxonomy (fields SkillCode and SkillDescription). Note: These fields require the Skills Classification add-on.

  • XML path:
    • //Skills/ComputerSkills[]/ComputerSkill/Skill (type string)
    • //Skills/ComputerSkills[]/ComputerSkill/SkillCode (type string) This field requires an additional add-on
    • //Skills/ComputerSkills[]/ComputerSkill/SkillDescription (type string) This field requires an additional add-on
  • JSON path:
    • $.skills.computerSkills[].skill (type string)
    • $.skills.computerSkills[].skillCode (type string) This field requires an additional add-on
    • $.skills.computerSkills[].skillDescription (type string) This field requires an additional add-on
Soft Skills object[] Add-on required for some fields

The list of soft skills required by the position, as extracted from the vacancy text (field Skill).

Additionally, the list of the extracted soft skills normalized to the Textkernel Skills Taxonomy (fields SkillCode and SkillDescription). Note: These fields require the Skills Classification add-on.

  • XML path:
    • //Skills/SoftSkills[]/SoftSkill/Skill (type string)
    • //Skills/SoftSkills[]/SoftSkill[]/SkillCode (type string) This field requires an additional add-on
    • //Skills/SoftSkills[]/SoftSkill/SkillDescription (type string) This field requires an additional add-on
  • JSON path:
    • $.skills.softSkills[].skill (type string)
    • $.skills.softSkills[].skillCode (type string) This field requires an additional add-on
    • $.skills.softSkills[].skillDescription (type string) This field requires an additional add-on
Professional Skills object[] Add-on required for some fields

The list of professional skills required by the position, as extracted from the vacancy text (field Skill).

Additionally, the list of the extracted professional skills normalized to the [Textkernel Skills classification]Textkernel Skills Taxonomy (fields SkillCode and SkillDescription). Note: This field requires the Skills Classification add-on.

  • XML path:
    • //Skills/OtherSkills[]/OtherSkill/Skill (type string)
    • //Skills/OtherSkills[]/OtherSkill/SkillCode (type string) This field requires an additional add-on
    • //Skills/OtherSkills[]/OtherSkill/SkillDescription (type string) This field requires an additional add-on
  • JSON path:
    • $.skills.otherSkills[].skill (type string)
    • $.skills.otherSkills[].skillCode (type string) This field requires an additional add-on
    • $.skills.otherSkills[].skillDescription (type string) This field requires an additional add-on
Full Vacancy Text string

The full text of the vacancy, excluding extra document elements (e.g. headers or footers).

  • XML path: //DocumentText
  • JSON path: $.documentText
Example JSON/XML 
{
    "skills": {
        "languageSkills": [
            {
                "skillCode": "en",
                "skillDescription": "English"
            },
            {
                "skillCode": "nl",
                "skillDescription": "Dutch"
            }
        ],
        "computerSkills": [
            {
                "skill": "Java",
                "skillCode": "KS120076FGP5WGWYMP0F",
                "skillDescription": "Java (Programming Language)"
            },
            {
                "skill": "Agile",
                "skillCode": "KS120B874P2P6BK1MQ0T",
                "skillDescription": "Agile Methodology"
            }
        ],
        "softSkills": [
            {
                "skill": "Good communication",
                "skillCode": "KS122556LMQ829GZCCRV",
                "skillDescription": "Communication Skills"
            }
        ],
        "otherSkills": [
            {
                "skill": "data capture",
                "skillCode": "KS122NR6NY1KB0TD40G4",
                "skillDescription": "Data Collection"
            }
        ]
    },
    "documentText": "..."
}

<JobInfo>
    <Skills>
        <LanguageSkills>
            <LanguageSkill>
                <SkillCode>en</SkillCode>
                <SkillDescription>English</SkillDescription>
            </LanguageSkill>
            <LanguageSkill>
                <SkillCode>nl</SkillCode>
                <SkillDescription>Dutch</SkillDescription>
            </LanguageSkill>
        </LanguageSkills>
        <ComputerSkills>
            <ComputerSkill>
                <Skill>Agile</Skill>
                <SkillCode>KS120B874P2P6BK1MQ0T</SkillCode>
                <SkillDescription>Agile Methodology</SkillDescription>
            </ComputerSkill>
            <ComputerSkill>
                <Skill>Java</Skill>
                <SkillCode>KS120076FGP5WGWYMP0F</SkillCode>
                <SkillDescription>Java (Programming Language)</SkillDescription>
            </ComputerSkill>
        </ComputerSkills>
        <SoftSkills>
            <SoftSkill>
                <Skill>Good communication</Skill>
                <SkillCode>KS122556LMQ829GZCCRV</SkillCode>
                <SkillDescription>Communication Skills</SkillDescription>
            </SoftSkill>
        </SoftSkills>
        <OtherSkills>
            <OtherSkill>
                <Skill>data capture</Skill>
                <SkillCode>KS122NR6NY1KB0TD40G4</SkillCode>
                <SkillDescription>Data Collection</SkillDescription>
            </OtherSkill>
        </OtherSkills>
    </Skills>
    <DocumentText>...</DocumentText>
</JobInfo>