XML Feed

Format

In theory we can support any type of XML or JSON 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:

<?xml version="1.0" encoding="UTF-8" ?>
<jobs>
  <job>
    <title><![CDATA[Python Developer]]></title>
    <url><![CDATA[https://www.example.com/view_job.php?id=12345]]></url>
    <location>
        <city><![CDATA[London]]></city>
        <region><![CDATA[Greater London]]></region>
        <country><![CDATA[United Kingdom]]></country>
    </location>
    <company><![CDATA[BBC]]></company>
    <company_url><![CDATA[https://www.bbc.co.uk/]]></company_url>
    <description>
       <![CDATA[
 complete job ad content <br>
 including <br>
 HTML formatting
        ]]>
    </description>
    <contract_type><![CDATA[permanent]]></contract_type>
    <working_hours><![CDATA[full-time]]></working_hours>
    <salary><![CDATA[£30000 - 33000]]></salary>
    <application_email><![CDATA[applyhere@example.com]]></application_email>
    <job_reference><![CDATA[FXGT-4312]]></job_reference>
    <apply_url><![CDATA[https://www.example.com/job_application.php?id=12345]]></apply_url>
    <careerjet-apply-data>
      <![CDATA[apply_key=043762d616698aa9ddef8a93624ee314&jobTitle=Python%20Developer&jobLocation=London%2C%20Greater%20London%2C%20United%20Kingdom&jobCompanyName=BBC&postUrl=https%3A%2F%2Fwww.example.com%2Fapply%2Fcareerjet%3Fref%3DFXGT-4312&phone=optional&coverletter=optional&hl=en_US]]>
    </careerjet-apply-data>
    <programmatic>
      <bid>
        <cost_model>CPC</cost_model>
        <currency_code>GBP</currency_code>
        <amount>2.50</amount>
      </bid>
    </programmatic>
  </job>
  <job>
    <title><![CDATA[Sales Manager]]></title>
    <url><![CDATA[https://www.example.com/view_job.php?id=12345]]></url>
    <location>
        <city><![CDATA[London]]></city>
        <region><![CDATA[Greater London]]></region>
        <country><![CDATA[United Kingdom]]></country>
    </location>
    <company><![CDATA[British Telecom]]></company>
    <company_url><![CDATA[https://www.bt.com/]]></company_url>
    <description>
       <![CDATA[
 complete job ad content <br>
 including <br>
 HTML formatting
       ]]>
    </description>
    <contract_type><![CDATA[permanent]]></contract_type>
    <working_hours><![CDATA[full-time]]></working_hours>
    <salary><![CDATA[£23000 - 28000]]></salary>
    <application_email><![CDATA[applyhere@example.com]]></application_email>
    <job_reference><![CDATA[FXGU-4313]]></job_reference>
    <apply_url><![CDATA[https://www.example.com/job_application.php?id=12345]]></apply_url>
    <careerjet-apply-data>
      <![CDATA[apply_key=043762d616698aa9ddef8a93624ee314&jobTitle=Sales%20Manager&jobLocation=London%2C%20Greater%20London%2C%20United%20Kingdom&jobCompanyName=British%20Telecom&postUrl=https%3A%2F%2Fwww.example.com%2Fapply%2Fcareerjet%3Fref%3DFXGU-4313&phone=optional&coverletter=optional&hl=en_US]]>
    </careerjet-apply-data>
    <programmatic>
      <bid>
        <cost_model>CPC</cost_model>
        <currency_code>USD</currency_code>
        <amount>3.50</amount>
      </bid>
    </programmatic>
  </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 (GMT). Ideally the feed directly connects to your database, so it is always up-to-date.