XML Feed Specification

XML Feed Format

You should create UTF-8 XML feed in format specified by our jobs technical specifications. 

Below are some simple guidelines for preparing the XML feed in order to have your jobs on JobLookup.

If you would like additional information about the XML format, please check Wikipedia.

The UTF-8 XML file has one 'jobs' tag, and one or more 'job' elements. Each 'job' element has obligatory* and optional fields.

Obligatory* Fields

These fields must be included in the feed as they contain the minimum amount of job information that our system requires to include your jobs on JobLookup.

• id: Identification of the job on your website (numeric or alphanumeric, however it must be unique).

• email: The email address that applications will be sent to.

• title: Job title.

• desc: Description of the job (minimum of 300 characters). Please make your job descriptions as detailed as possible for best conversation rate.

• country: The country the job is based in, e.g: UK.

Optional Fields

You don't have to fill out the optional fields. However, if you do have the information, please don't hesitate to include it. JobLookup's algorithm prioritises higher-quality jobs, so including more information optimises your positioning!

• location: Jobs' location, where the job is located.

• salary: Salary of the job.

• job-type: Type of the job (permanent, temporary, contract, placement-student and seasonal).

• job-status: Status of the job (full-time, part-time etc..).

• postcode: Postcode.

• latitude: Latitude.

• longitude: Longitude.

• reference: Can be a numeric or an alphanumeric value.

• company-name: Hiring company name (do not include recruiting agencies' names).

• company-logo: Hiring company logo file.

• expiration-date: Expiration date of the job (format: YYYY-MM-DD)

Your XML feed should look like this:

(Swipe left to see more)

<?xml version="1.0" encoding="UTF-8"?>
<jobs xmlns="https://joblookup.com/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://joblookup.com/XMLSchema https://joblookup.com/XMLSchema.xsd ">
 <job>
   <id><![CDATA[...]]></id>
   <email><![CDATA[...]]></email>
   <title><![CDATA[...]]></title>
   <desc><![CDATA[...]]></desc>
   <location><![CDATA[...]]></location>
   <country><![CDATA[...]]></country>
   <salary><![CDATA[...]]></salary>
   <job-type><![CDATA[...]]></job-type>
   <job-status><![CDATA[...]]></job-status>
   <postcode><![CDATA[...]]></postcode>
   <latitude><![CDATA[...]]></latitude>
   <longitude><![CDATA[...]]></longitude>
   <reference><![CDATA[...]]></reference>
   <company-name><![CDATA[...]]></company-name>
   <company-logo><![CDATA[...]]></company-logo>
   <expiration-date><![CDATA[...]]></expiration-date>
 </job>
</jobs>

Example XML feed:

(Swipe left to see more)

<?xml version="1.0" encoding="UTF-8"?>
<jobs xmlns="https://joblookup.com/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://joblookup.com/XMLSchema jobs.xsd ">
 <job>
   <id><![CDATA[123456]]></id>
   <email><![CDATA[[email protected]]]></email>
   <title><![CDATA[Sales Team Leader]]></title>
   <desc><![CDATA[We are looking for an energetic experienced Telesales person to join a growing Company based in oxford. The Successful candidate must have a minimum of 5 years experience of leading a telesales team. You must have impressive leadership skills and the ability to consistently motivate your team. The successful candidate must lead by example and have the ability to coach and support the team to achieve targets. You must be confident with a great person...]]></desc>
   <location><![CDATA[England, South East, Oxfordshire, Oxford]]></location>
   <country><![CDATA[UK]]></country>
   <salary><![CDATA[10000 to 20000 annum]]></salary>
   <job-type><![CDATA[permanent]]></job-type>
   <job-status><![CDATA[full-time]]></job-status>
   <postcode><![CDATA[OX1 3BJ]]></postcode>
   <latitude><![CDATA[51.7555617]]></latitude>
   <longitude><![CDATA[-1.2597132]]></longitude>
   <reference><![CDATA[sales-i2535]]></reference>
   <company-name><![CDATA[Balliol College]]></company-name>
   <company-logo><![CDATA[http://www.ajobsite.com/images/logo/123456.png]]></company-logo>
   <expiration-date><![CDATA[2011-05-21]]></expiration-date>
 </job>
</jobs>

XML Schema

(Swipe left to see more)

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 targetNamespace="https://joblookup.com/XMLSchema"
 xmlns="https://joblookup.com/XMLSchema"
 elementFormDefault="qualified">
   <xsd:element name="jobs" type="t-jobs"/>
 <xsd:complexType name="t-jobs">
   <xsd:sequence>
     <xsd:element name="job" type="t-job" maxOccurs="unbounded" minOccurs="1"/>
   </xsd:sequence>
 </xsd:complexType>
 <xsd:complexType name="t-job">
   <xsd:sequence>
     <xsd:element name="id" type="xsd:string" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="email" type="xsd:string" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="title" type="xsd:string" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="desc" type="t-description" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="location" type="xsd:string" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="country" type="xsd:string" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="salary" type="xsd:string" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="job-type" type="t-job-type" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="job-status" type="t-job-status" maxOccurs="1" minOccurs="1"/>
     <xsd:element name="postcode" type="xsd:string" maxOccurs="1" minOccurs="0"/>
     <xsd:element name="latitude" type="xsd:string" maxOccurs="1" minOccurs="0"/>
     <xsd:element name="longitude" type="xsd:string" maxOccurs="1" minOccurs="0"/>
     <xsd:element name="reference" type="xsd:string" maxOccurs="1" minOccurs="0"/>
     <xsd:element name="company-name" type="xsd:string" maxOccurs="1" minOccurs="0"/>
     <xsd:element name="company-logo" type="xsd:string" maxOccurs="1" minOccurs="0"/>
     <xsd:element name="expiration-date" type="xsd:date" maxOccurs="1" minOccurs="0"/>
   </xsd:sequence>
 </xsd:complexType>
 <xsd:simpleType name="t-description">
   <xsd:restriction base="xsd:string">
     <xsd:minLength value="300"/>
   </xsd:restriction>
 </xsd:simpleType>
 <xsd:simpleType name="t-job-type">
   <xsd:restriction base="xsd:string">
     <xsd:enumeration value="permanent"></xsd:enumeration>
     <xsd:enumeration value="temporary"></xsd:enumeration>
     <xsd:enumeration value="contract"></xsd:enumeration>
     <xsd:enumeration value="placement-student"></xsd:enumeration>
     <xsd:enumeration value="seasonal"></xsd:enumeration>
   </xsd:restriction>
 </xsd:simpleType>
 <xsd:simpleType name="t-job-status">
   <xsd:restriction base="xsd:string">
     <xsd:enumeration value="full-time"></xsd:enumeration>
     <xsd:enumeration value="part-time"></xsd:enumeration>
   </xsd:restriction>
 </xsd:simpleType>
</xsd:schema>