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. Healthcare Careers 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 to ensure that your feed will work, please note the mandatory fields in the example below. 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 required.

<?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> *
   <profession><![CDATA[Profession]]></profession>
   <country><![CDATA[Country]]></country> *
   <state><![CDATA[State]]></state> 
   <city><![CDATA[City or Location]]></city> *
   <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>
   <apply_url><![CDATA[Application URL]]></apply_url>
  </job>
  <job>
   <company><![CDATA[XYZ Employer]]></company>
   <reference><![CDATA[K4-22743]]></reference> *
   <title><![CDATA[Consultant Gastroenterologist]]></title> *
   <profession><![CDATA[Doctor / Physician]]></profession>
   <url><![CDATA[http://www.yoursite.com/view_job.php?id=12345]]></url> *
   <country><![CDATA[United Kingdom]]></country> *
   <state><![CDATA[West Yorkshire]]></state> *
   <city><![CDATA[Leeds]]></city> *
   <postcode><![CDATA[LS1 2YH]]></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 Leeds
    ... ]]> </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[[email protected]]]></application_email>
   <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 posting is not in the feed, we won't list it.

Update frequency

Your feed needs to be updated at least once a day. Ideally the feed directly connects to your own database of job postings, 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.

Make sure you use the correct encoding

In the example above, all the 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.