Skip to main content

XML Job Feed - Integration Guide

Updated

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.
Important: The feed URL must remain stable and accessible at all times. The URL should not change between updates — only the content of the feed at that address should change when job listings are added or removed.

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.

3. Feed Requirements

3.1 General Constraints

  • The feed can contain a maximum of 10,000 jobs
  • 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:

XML
<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.

Field / Tag Requirement Description
<jobId> Required A unique identifier for each job listing. This value is used to track jobs across feed updates and must not change for the lifetime of the job listing.
<title> Required The job title as plain text (e.g., "Senior Software Engineer").
<description> Required The full job description. HTML content is supported and should be wrapped in a CDATA section.
<company> Required The name of the hiring organisation.
<country> Required ISO 3166-1 alpha-2 country code (e.g., US, GB, DE).
<state> Required The state, province, or administrative region of the job location.
<city> Required The city or locality of the job location.
<postalCode> Required The postal or ZIP code of the job location.
<postedAt> Recommended The date the job was originally published.
<jobUrl> Recommended The URL to which candidates are directed when they click the Apply button. Must be a fully-qualified URL.
<applicationEmail> Recommended An email address to which applications should be forwarded. Useful for ATS systems that accept inbound applications via email. This can be ignored if the URL is used instead.
<category> Recommended The occupational category or job function (e.g., Engineering, Sales, Healthcare).
<companyLogo> Recommended A publicly accessible URL to the hiring company’s logo image.
<address> Recommended A full formatted street address, if available (e.g., "123 Main St, Richmond, VA 23890").
<salaryMin> Recommended The minimum value of the advertised salary range (numeric value only).
<salaryMax> Recommended The maximum value of the advertised salary range (numeric value only).
<salaryCurrency> Recommended ISO 4217 currency code for the salary values (e.g., USD, EUR, GBP).
<salaryFrequency> Recommended The payment frequency. Accepted values: Hourly, Daily, Weekly, Monthly, Yearly.

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:

XML
<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.