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