XML Job Feed - Integration Guide

1. Overview

The Jobiqo platform supports automated job ingestion via XML feeds, enabling feed providers to populate and maintain a job board with minimal manual intervention. The system is designed to be highly flexible in field mapping, accommodating a variety of XML structures as long as the feed is well-formed and contains the required elements described in this guide.

This document outlines the technical requirements for setting up a compatible XML feed, including mandatory and recommended fields, feed delivery expectations, and a reference example.

2. How the Feed Works

The XML feed import process is fully automated. Once a feed URL has been configured in the Jobiqo platform, the system performs the following steps on a recurring basis:

• The import process runs automatically every few hours.
• On each run, the system fetches the current XML content from the provided feed URL.
• New job listings present in the feed but not yet on the platform are automatically published.
• Job listings that were previously imported but are no longer present in the feed are automatically unpublished from the job board.
• This ensures the job board remains continuously synchronised with the contents of the XML feed.

Feed providers have direct control over which jobs appear on the job board: adding a job to the feed will publish it, and removing a job from the feed will unpublish it.

SEO Note: It is important to understand that the deletion of already published jobs will result in 404 error pages and may affect your SEO performance.

3. Feed Requirements

3.1 General Constraints

• The feed can contain a maximum of 10,000 jobs
• Job Titles have a character limit of 255
• Job Descriptions have a character limit of 32,000
• Allowed file extensions for logos are: png, gif, jpg, jpeg. The max file size is 5 MB. 
• The XML feed needs to have a valid XML structure
• The XML feed needs to be accessible on a URL
• The XML feed can be protected via username/password, but the access information needs to be provided

3.2 Job Tag Structure

The Jobiqo import system must be configured with the name of the XML tag that represents a single job entry. The standard recommended structure uses a root <jobs> element containing individual <job> child elements, as shown below:

<jobs>
  <job>
    <!-- job fields -->
  </job>
  <job>
    <!-- job fields -->
  </job>
</jobs>

Alternative tag names (e.g., <listings> / <listing>) are supported,  provided the tag names are consistent across the same XML feed. Mixing tags for the same object is not supported (ex <jobs> and <listings> used in the same feed). 

4. Field Reference

The table below lists all supported fields, their requirement level, and a description of the expected content.

5. Example XML Feed

The following is a representative example of a well-formed XML feed containing a single job listing with all recommended fields populated:

<jobs>
  <job>
    <jobId><![CDATA[12345]]></jobId>
    <title><![CDATA[Senior Software Engineer]]></title>
    <description><![CDATA[Full job description here...]]></description>
    <company><![CDATA[Acme Corporation]]></company>
    <city><![CDATA[Richmond]]></city>
    <state><![CDATA[VA]]></state>
    <country><![CDATA[US]]></country>
    <postalCode><![CDATA[23890]]></postalCode>
    <postedAt><![CDATA[2024-03-01T10:00:00Z]]></postedAt>
    <jobUrl><![CDATA[https://example.com/apply/12345]]></jobUrl>
    <applicationEmail><![CDATA[jobs@example.com]]></applicationEmail>
    <category><![CDATA[Engineering]]></category>
    <companyLogo><![CDATA[https://example.com/logo.png]]></companyLogo>
    <salaryMin><![CDATA[80000]]></salaryMin>
    <salaryMax><![CDATA[120000]]></salaryMax>
    <salaryCurrency><![CDATA[USD]]></salaryCurrency>
    <salaryFrequency><![CDATA[Yearly]]></salaryFrequency>
  </job>
</jobs>

6. Onboarding & Configuration

To enable XML feed import for your job board, please provide the following information to the Jobiqo integration team:

• The URL for the feed
• Authentication information (if the feed is protected)

The Jobiqo team will configure the field mapping on the platform side, so no changes to your existing feed structure are required, provided all mandatory data is present.

6.1 Comprehensive Onboarding Questionnaire

If you want Jobiqo to set up the importer (setup costs occur), please collect and provide the following detailed parameters:

7. Administrative & Backend Setup (For Site Admins)

Before you set up a new XML importer, please make sure that you are familiar with the Jobiqo importer interface.

Step 1: Accessing the Interface

1. Log in with a (site) admin account and navigate to Jobs → Job Importer or go to /admin/content/feed.
2. Click on "Add Feed" on the top-right of the page or navigate directly to /feed/add.
   • Note: Once the importer is created, the importer type (Template vs Link) cannot be changed.

• Job importer template: For regular job ads with text content.
• Job importer per link: For jobs embedded via a Job Widget (uses an iFrame).

Step 2: Administrative Settings & Configuration

• Title: Define an internal name to distinguish multiple importers (e.g., Deutsche Bank Prescreen XML Import).
• Feed URL: Copy and paste the stable feed link here.
• Context: Define the XPath path to the first job, depending on your XML's structure. This must always start with a slash (/) and descend to the item element (e.g., /data/jobs/job or /smartrecruitersfeed/jobs/job). All subsequent fields are configured relative to this context path.

• Feeds item : guid: This field must always be configured and mapped to the unique reference ID of the job posting within the XML. This identifier must be entirely unique across the whole feed and must remain permanent for the lifetime of the job listing to avoid duplicates and ensure successful updates.

  

  Example: /data/jobs/job

  

  Example: /smartrecruitersfeed/jobs/job

Step 3: Save and Import

• Set import options to "Active" to enable the automatic recurring sync.
• Click on "Save and Import" to immediately import the jobs, or click "Save" to save the configurations without launching the initial import. 

8. Taxonomy Management & Synonym Mapping

Usually, the occupations, employment types, or other categories in an external XML feed (used by an external ATS) do not match your exact Jobiqo taxonomy terms.

You can add importer synonyms directly in Jobiqo's Taxonomy Manager to map the feed's terms to your platform's native categories without modifying the source XML file.

• Note: If you add the same synonym to two or more taxonomy terms, a job will be automatically autotagged with all matching terms during ingestion.

Synonym Mapping Example:

• Term in XML Feed: Half time → Target Taxonomy in Jobiqo: Part time
• Term in XML Feed: Administration → Target Taxonomy in Jobiqo: Assistance / Administration 

9. Maintenance & Troubleshooting

For advanced configurations, error handling, and operational workflows, please refer to the following internal articles:

• "Importer Interface" – Detailed guide to all supported functions of the import system.
• "What should I consider when testing a new XML importer" – Best practices for configuring safe staging environments and reviewing jobs before they go live.
• "Importer: most common errors" – Troubleshooting log definitions, connection issues, and syntax errors.
• "How can I edit an imported job" & "How can I update an imported job" – Instructions for manual updates, overrides, and modifying active imports.