Submitting an XML Feed of your jobs

If you have your own website displaying your jobs, one of the easiest ways to interface with us and have all your jobs displayed with no additional effort required on your part is to create an XML feed. Careers.Global can automatically import and update your jobs on a daily basis. This ensures that your jobs are always current and reflecting what you are recruiting for.

The following job posting services already provide interfaces to our career portal, however we are certainly not limited to just these.

Format

In theory we can support any type of XML feed, so if you have an existing feed just send it to us. However if you need to create a feed from scratch, we suggest you use the following format:
Please note that fields marked with * should be included if possible. Those not marked with * are optional.

<?xml version="1.0" encoding="UTF-8" ?>
 <jobs>
  <job>
   <company><![CDATA[Your Company Name]]></company>
   <reference><![CDATA[Your Reference Number]]></reference> *
   <title><![CDATA[Job Title]]></title> *
   <sector><![CDATA[Sector]]></sector> *
   <profession><![CDATA[Profession]]></profession> *
   <url><![CDATA[Job Display URL]]></url> *
   <country><![CDATA[Country]]></country> *
   <location><![CDATA[City or Location]]></location> *
   <postcode><![CDATA[Postal Code]]></postcode>
   <brief_description><![CDATA[Brief Description]]></brief_description> *
   <description> <![CDATA[ complete job ad content including HTML formatting ]]> </description> *
   <contract_type><![CDATA[Employment Type]]></contract_type> *
   <salary><![CDATA[Amount Paid]]></salary> *
   <salary_frequency><![CDATA[How Paid]]></salary_frequency> *
   <currency><![CDATA[Currency Code]]></currency> *
   <application_email><![CDATA[AApplication Email]]></application_email>
   <phone><![CDATA[Application Phone]]></phone>
   <apply_url><![CDATA[Application URL]]></apply_url>
  </job>
  <job>
   <company><![CDATA[XYZ Employer]]></company>
   <reference><![CDATA[K4-22743]]></reference> *
   <title><![CDATA[Consultant Gastroenterologist]]></title> *
   <sector><![CDATA[Healthcare and Medical]]></sector> *
   <profession><![CDATA[Medical Specialist]]></profession> *
   <url><![CDATA[http://www.yoursite.com/view_job.php?id=12345]]></url> *
   <country><![CDATA[Saudi Arbia]]></country> *
   <location><![CDATA[Riyadh]]></location> *
   <postcode><![CDATA[200012]]></postcode>
   <brief_description><![CDATA[We are looking to appoint a Consultant 
    Gastroent... ]]></brief_description> *
   <description> <![CDATA[ <p>We are inviting applications for the position 
    of Consultant Gastroenterologist</p><p>Located in our facility in Riyadh
    ... ]]> </description> *
   <contract_type><![CDATA[Full Time]]></contract_type> *
   <salary><![CDATA[60,000]]></salary> *
   <salary_frequency><![CDATA[per Month]]></salary_frequency> *
   <currency><![CDATA[SAR]]></currency> *
   <application_email><![CDATA[applyhere@yoursite.com]]></application_email>
   <phone><![CDATA[+1-555-754-3010]]></phone>
   <apply_url><![CDATA[http://www.yoursite.com/job_application.php?id=12345]]></apply_url>
  </job>

... 
</jobs>

Feed content

The feed needs to contain all of your jobs and not just your new jobs. If a job is not in the feed we won't list it.

Update frequency

Your feed needs to be updated at least once a day, preferably just before midnight. Ideally the feed directly connects to your database, so it is always up-to-date.

Guidelines

For optimal processing and to minimise delays in activating your feed, please note the following.

  1. Country should be in the format of the full country name, and NOT abbreviated - "Australia" rather than "AU"
  2. Currency should be in the three character international standard - "AUD", "USD", "GBP", "AED" etc.
  3. Phone field should not contain any alpha character (letters). Use the country code if possible. If the submitted field contains "Call UK Toll Free 0845 111 1111" the feed will not work as it contains characters that are not permitted.

Make sure you use the correct encoding - in the example all our data needs to be encoded in UTF-8. If you cannot handle this encoding, try ISO-8859-1 if your data was written in a West-European language that uses Roman letters, ISO-8859-2 for Central European languages, Windows-1251 for Cyrillic-based languages, ISO-8859-7 for Greek, GB2312 for Simplified Chinese and Shift_JS for Japanese. Don't forget to specify the encoding at the top of your feed.

Use of reserved characters in data - characters such as <, >, ', " and & are not allowed to appear standalone in data records unless those are protected by a CDATA declaration. Those characters need to be encoded (< becomes &lt;, > becomes &gt;, ' becomes &apos;, " becomes &quot; and & becomes &amp;)

HTML entities in data - HTML entities such as &eacute; that stands for é should not appear in the data. You can either use the character directly or use the &#nnnn; or &#xhhhh; format.

Support

Is this as clear as mud? Don't panic! If you or your technical team need support or further details, please feel free to contact us.

 

This website uses cookies

This website uses cookies to improve user experience. By using our website you consent to all cookies in accordance with our Cookie Policy.
I agree
Read more