Standard XML Feed for Job Boards

Third-party job boards that need to retrieve jobs from iCIMS Applicant Tracking (formerly Recruit) career sites or iCIMS Career Sites (formerly Attract) can request access to an optimized standard XML feed to streamline job distribution. iCIMS compiles customers’ jobs into a standard XML feed with consistent formatting and provides the feed to approved job boards every four hours using the Job Feed Service microservice to keep job postings accurate and current.

The standard XML feed offers the same job posting data to multiple job boards that have authenticated to retrieve the XML feed content from the Job Feed Service. The feed includes the same job fields across all customers, so job boards receive consistent content in the feed elements. The only difference amongst job boards is the apply URL which contains the name of the individual job board consuming the feed; this is to automatically capture the source of the candidate applying to the job.

The standard XML feed allows iCIMS customers to opt out of sending their jobs to specific job boards. Customers can contact iCIMS Technical Support to disable the optimized standard XML feed for any job board(s), either for all career sites or on a per-career site basis via the XML Feed Integrations setting.

FAQ

What does a vendor need to consume the standard XML feed?

All vendors who wish to consume the new XML feed must support OAuth 2.0 as a form of authentication. For more information on how to use OAuth 2.0 to authenticate with the Job Feed Service, review the Authenticating API Calls with OAuth 2.0 developer documentation.

How can a vendor sign up with iCIMS to consume the standard XML feed?

Vendors can complete this "form" to request initial access to the XML feed, an iCIMS representative will reach out to complete the process. During vendor onboarding, they will get a client_id and client_secret for test and prod environments. Our test and prod environments are public, so as long as the vendor has authenticated properly, they can access the service. After a vendor is added to the feed customers may contact the iCIMS Support website by clicking Help in their iCIMS Talent Platform to request the vendor be added to their platform.

What is the data format?

The jobs are provided in a zipped XML file. The zip file name will be {vendorName}-job-postings.zip and xml file name will be {vendorName}-job-postings.xml. Depending on the number of jobs in the ZIP, the ZIP is expected to be around 200-500+ MB.

<JobPosting>
      <referenceId>
              <![CDATA[]]>
      </referenceId>
      <url>
              <![CDATA[]]>
      </url>
      <title>
              <![CDATA[]]>
      </title>
      <description>
              <![CDATA[Overview:
              Responsibilities:
              Qualifications:
              ]]>
      </description>
      <datePosted>
              <![CDATA[]]>
      </datePosted>
      <jobType>
              <![CDATA[]]>
      </jobType>
      <hiringOrganization>
              <![CDATA[]]>
      </hiringOrganization>
      <city>
              <![CDATA[]]>
      </city>
      <state>
              <![CDATA[]]>
      </state>
      <country>
              <![CDATA[]]>
      </country>
      <postalCode>
              <![CDATA[]]>
      </postalCode>
      <streetAddress>
              <![CDATA[]]>
      </streetAddress>
      <other>
              <![CDATA[]]>
      </other>
</JobPosting>

Standard XML Job Posting Field Values

The following elements are provided in the standard XML feed for each job posting:

<referenceID>: The unique identifier assigned by iCIMS to a job.
<url>: The URL of the job posted to the relevant career site (i.e., the link for the candidate to apply). The URL contains client-tailored auto-sourcing (utm_source) parameters.
<title>: The value of the field mapped to the Schema.org JSON-LD Property Title, if posted to the Job Header section of the relevant career site’s Postable Fields in the iCIMS system.
<description>: The value of the field(s) included in the Job Description section of the relevant career site’s Postable Fields (i.e., Overview, Responsibilities, Qualifications) in the iCIMS system.
<datePosted>: The date the job was posted to the relevant career site from the iCIMS system.
<validThrough>: How long the job is posted for; this will only be included if there is an end date for the job posting in the iCIMS system.
<jobType>: The value of the field mapped to the Schema.org JSON-LD Property Employment Type, if posted to the Job Header section of the relevant career site’s Postable Fields in the iCIMS system. For example, the value may be Permanent Full Time, Part Time, etc.
<hiringOrganization>: The company name for the job posting determined by the value of the field mapped to the Schema.org JSON-LD Property JobPosting Hiring Organization Name in the iCIMS system. If this is not mapped, the value of the Schema.org JobPosting Hiring Organization Name setting from the iCIMS system is used.
<city>: The value of the field mapped to the Job Posting Field Mapping setting City in the iCIMS system. By default, the city of the default Location address (Location: City) is mapped to this setting and included in the feed. If field mapping is removed from the City setting, the system automatically sends the city of the default Location address in the feed.
<state>: The value of the field mapped to the Job Posting Field Mapping setting State/Province in the iCIMS system. By default, the state/province of the default Location address (Location: State/Province) is mapped to this setting and included in the feed. If field mapping is removed from the State/Province setting, the system automatically sends the state/province of the default Location address in the feed.
<country>: The value of the field mapped to the Job Posting Field Mapping setting Country in the iCIMS system. By default, the country of the default Location address (Location: Country) is mapped to this setting and included in the feed. If field mapping is removed from the Country setting, the system automatically sends the country of the default Location address in the feed.
<postalCode>: The value of the field mapped to the Job Posting Field Mapping setting Postal Code in the iCIMS system. By default, the postal code of the default Location address (Location: Postal Code) is mapped to this setting and included in the feed. If field mapping is removed from the Postal Code setting, the system automatically sends the postal code of the default Location address in the feed.
<streetAddress>: The value of the field mapped to the Job Posting Field Mapping setting Address Lines. By default, the first two lines of the default Location address (Location: Address and Location: Address 2) are mapped to this setting and included in the feed. If field mapping is removed from the Address Lines setting, the system automatically sends the first two lines of the default Location address in the feed.
<other>: Any fields included in the Job Header section of the relevant career site’s Postable Fields in the iCIMS system that include other job data (e.g., number of positions).

Example XML Feed

The following example demonstrates how a job appears within the feed. (Note: The job description within this example has been truncated for concision.)

<?xml version="1.0" encoding="UTF-8"?>
<source>
    <publisher>
        <![CDATA[iCIMS]]>
    </publisher>
    <publisherurl>
        <![CDATA[https://icims.com]]>
    </publisherurl>
    <JobPosting>
        <referenceId>
            <![CDATA[2709fa2b-e0c4-4ec6-a7d2-6840fd9c41c0]]>
        </referenceId>
        <url>
            <![CDATA[https://careers-test774.icims.com/jobs/1000/job?utm_source=vendor_integration&iis=Job%20Board&iisn=Vendor]]>
        </url>
        <title>
            <![CDATA[Test Job 1]]>
        </title>
        <description>
            <![CDATA[Overview: <p style="margin: 0px"><strong>What do you get when you bring together the brightest minds and place them into an exciting, fast-paced environment that fosters intellectual growth and rewards based on impact, not tenure?</strong></p><p style="margin: 0px"></p><p style="margin: 0px">You get one of the fastest growing Software-as-a-Service companies in the United States. iCIMS is an Inc. 500 & Deloitte Fast 500 ASP Software Firm focused on solving corporate business issues through the implementation of easy-to-use, web-based software solutions.</p><p style="margin: 0px"></p> 
            
            Responsibilities:
            As a member of the Account Services Department, the Manager will work closely with the iCIMS customers to ensure all their needs and expectations are met. <p style="margin: 0px">- The Manager should have a strong knowledge of ASP systems and the ability to quickly learn and master the iRecruiter system to effectively communicate to customers the best and most efficient methods of utilizing iCIMS products. </p><p style="margin: 0px">- The Manager should possess outstanding interpersonal skills and the ability to effectively manage multiple accounts. </p><p style="margin: 0px">- The Manager is expected to be able to identify a customer's needs and when new opportunities exist to add additional products and services.</p> 
            
            ]]>
        </description>
        <datePosted>
            <![CDATA[2014-07-11T15:49:00Z]]>
        </datePosted>
        <hiringOrganization>
            <![CDATA[CP Tech]]>
        </hiringOrganization>
        <city>
            <![CDATA[New York]]>
        </city>
        <state>
            <![CDATA[NY]]>
        </state>
        <country>
            <![CDATA[US]]>
        </country>
        <other>
            <![CDATA[Requisition Title|Test Job 1,Requisition ID|2010-1000,Position Type (Portal Searching)|Regular Full-Time,Job Locations|US-NY-New York,# of Openings|1,Category (Portal Searching)|Human Resources,Location : Location|US-NY-New York]]>
        </other>
    </JobPosting>
</source>