Feed specifications - Version 2

Introduction:

On this page we specify the requirements for xml feeds that we import. Please make sure the feed will include at least all of the mandatory fields as described here.


Sample feed:

<?xml version="1.0" encoding="UTF-8"?>
<jobs>
  <job>
    <id>417275</id>
    <url>https://www.studentjob.co.uk/vacancies/417275-fun-flexible-event-work-between-8-50-and-11-50-per-hour-immediate-start-in-london</url>
    <title>Fun &amp; Flexible Event Work between £8.50 and £11.50 per hour- (Immediate start!) </title>
    <function_title>Bar and Waiting Event Staff</function_title>
    <responsibilities>Operational tasks (bar and waiting staff)</responsibilities>
    <location>
      <nationwide/>
      <city>London</city>
      <postalcode>SW12 9ER</postalcode>
    </location>
    <description>
      <summary>
        <![CDATA[High Society if offering over the course of Summer 2021, the chance to work at some exclusive venues, which have customer dining packages tailor made to suit the current restrictions and environment.  We are looking for part-time bar and waiting staff, who can take instruction well, and assist in these fantastic vibrant events in and around London; such as the iconic Albert Hall, Syon House and in central London, Somerset House.]]>
      </summary>
      <long_description>
        <![CDATA[]]>
      </long_description>
    </description>
    <hours_per_week>
      <working_hours_min>5</working_hours_min>
      <working_hours_max>32</working_hours_max>
    </hours_per_week>
    <job_types>
      <job_type>parttime</job_type>
      <job_type>weekend</job_type>
      <job_type>fulltime_experience</job_type>
    </job_types>
    <functions>
      <function>
        <reference>bar-staff-jobs</reference>
      </function>
    </functions>
    <education_types>
      <education_type>college</education_type>
      <education_type>university</education_type>
    </education_types>
    <languages>
      <language>english</language>
    </languages>
    <salary>
      <currency>£</currency>
      <min>8.5</min>
      <max>11.5</max>
      <salary_rate>0</salary_rate>
    </salary>
    <drivers_license>false</drivers_license>
  </job>
  <job>
    <id>438012</id>
    <url>https://www.studentjob.co.uk/vacancies/438012-online-part-time-tutoring-teaching-jobs-across-the-uk</url>
    <title>Online Part-time Tutoring &amp; Teaching jobs across the UK</title>
    <function_title>Tutor</function_title>
    <responsibilities>Tutor</responsibilities>
    <location>
      <nationwide/>
      <city>London</city>
      <postalcode>W1J 9HP</postalcode>
    </location>
    <description>
      <summary>
        <![CDATA[Superprof, the UK’s #1 tutoring network, are offering you the chance to become an online tutor and start tutoring at a time and price that suits you.]]>
      </summary>
      <long_description>
        <![CDATA[<p>Tutoring is the ideal job for students, graduates, people starting their own business, and anyone who wants to earn extra money during the evenings or weekends.</p><span id="docs-internal-guid-feab3dc7-14c5-5ce2-625e-56727852477d"><p><br></p>
<p dir="ltr" style="line-height:1.2;margin-top:0pt;margin-bottom:0pt;">We are looking for motivated and passionate people from across the UK (both with tutoring experience and without) to tutor in 1000+ subjects including:</p><p><br></p>
<ul><li dir="ltr">Academic (physics, chemistry, French, history, maths, coding, test preparation, etc.)</li><li dir="ltr">Sports (fitness, personal coaching, swimming, sailing, skiing, skateboarding, tennis, etc.)</li><li dir="ltr">Arts & Leisure (guitar, piano, singing, pottery, illustration, cooking, etc.)</li></ul><p><br></p>
<p dir="ltr" style="line-height:1.2;margin-top:0pt;margin-bottom:0pt;">With Superprof you can set your own rates, manage your own time and connect with thousands of potential students.</p><p><br></p>
<p dir="ltr" style="line-height:1.2;margin-top:0pt;margin-bottom:0pt;">It is completely free to sign up, become a tutor and start advertising your services today.</p><p><br></p>
<p dir="ltr" style="line-height:1.2;margin-top:0pt;margin-bottom:0pt;">Just follow the link by clicking 'Apply online'.</p><p><br></p>
<p dir="ltr" style="line-height:1.2;margin-top:0pt;margin-bottom:0pt;">The advantages:</p><ul><li dir="ltr">Free registration and no user fees (we do not charge commission)</li><li dir="ltr">Set your own rates and work schedule. Be your own boss!</li><li dir="ltr">Teach from home, in your local area or online</li><li dir="ltr">Thousands of potential students</li></ul><p><br></p>
<p dir="ltr" style="line-height:1.2;margin-top:0pt;margin-bottom:0pt;">The ideal profile:</p><ul><li dir="ltr">You want to pass on your knowledge to new students</li><li dir="ltr">You have a school qualification/practical experience/university degree in the subject you wish to teach</li><li dir="ltr">You are patient, punctual and a good educator</li><li dir="ltr">Like us, you think everyone has something special to share.</li></ul><p><br></p>
<p dir="ltr" style="line-height:1.2;margin-top:0pt;margin-bottom:0pt;">To find out more about Superprof, visit our Website or Company profile on StudentJob: <a href="https://www.studentjob.co.uk/company-profile/superprof-vacancies">https://www.studentjob.co.uk/company-profile/super...</a></p></span>]]>
      </long_description>
    </description>
    <hours_per_week>
      <working_hours_min>24</working_hours_min>
      <working_hours_max>38</working_hours_max>
    </hours_per_week>
    <job_types>
      <job_type>fulltime</job_type>
      <job_type>parttime</job_type>
      <job_type>evening</job_type>
      <job_type>weekend</job_type>
      <job_type>holiday</job_type>
    </job_types>
    <functions>
      <function>
        <reference>teaching-jobs</reference>
      </function>
    </functions>
    <education_types>
      <education_type>secondary school</education_type>
      <education_type>college</education_type>
      <education_type>university</education_type>
      <education_type>other</education_type>
    </education_types>
    <languages>
      <language>english</language>
    </languages>
    <salary>
      <currency>£</currency>
      <min>10.0</min>
      <max>50.0</max>
      <salary_rate>0</salary_rate>
    </salary>
    <drivers_license/>
  </job>
</jobs>

Reasoning:

With our job openings we are trying to comply with the standard defined by schema.org, JobPosting, by doing this we are easier and better discoverable in google. With the new vacancy search system build by Google and already available in the US there are some extra requirements coming from Google as well with which we try to comply as much as possible.

XSD:

The XSD for the xml can be found here: XSD

Fields:

<id>, Mandatory
The id in your own system, we use this to identify your job opening in our system. This must be unique per job opening.
<url>, Mandatory
An url we can use to redirect the candidates to when they want to apply. Must be a string of at most 255 characters.
<title>, Mandatory
The title of the job opening. Must be a string of at most 255 characters.
<function_title>
The name of the function, for example: Account Manager. Must be a string of at most 35 characters and cannot contain ! or ?.
<responsibilities>
The main responsibility of this vacancy, for example: Responsible for operational tasks. Must be a string of at most 255 characters and cannot contain ! or ?.
<location>, Mandatory
Either nationwide is present here, or city and postalcode combination.
<nationwide>, Mandatory
Flag indicating that this is a nationwide job opening. Must be a boolean.
<city>, Mandatory
This city where this vacancy is taking place. Must be a string of at most 255 characters. The postalcode and the city should match for best vacancy experience!
<postalcode>, Mandatory
This contains the postalcode of this vacancy. Must be a string and a valid postalcode.
<description>, Mandatory
<summary>, Mandatory
A small introduction text for the job opening. This will be shown on the search results page of the job openings. Must be a string of at most 65535 characters.
<long_description>, Mandatory
Describe the function, what you offer to the candidate, what you request from the candidate, and possibly some extra info.
<hours_per_week>
The hours per week the candidate will be working. Please keep this in line with <job_types> you chose.
<working_hours_min>
Minimum amount of work hours
<working_hours_max>
Maximum amount of work hours.
<job_types>, Mandatory
List of <job_type> elements which contains the job type that are associated with this vacancy. At most one specified per <job_type> element. Possible values are:
  • parttime
  • evening
  • fulltime_experience
  • graduation_internship
  • fulltime
  • internship
  • traineeship
  • holiday
  • fulltime_temporary
  • voluntary
  • weekend
  • work_from_home
<functions>, Mandatory
List of <function> elements which contains the function that are associated with this vacancy. There should be at least 1 function specified and at most 2.
<reference>, Mandatory
The reference of the function
<professions>, Mandatory
List of <profession> elements which contains the profession that are associated with this vacancy. At most one specified per <profession> element. The profession is a sub specification of the function. There should be at least 1 and at most 2 professions specified.
Possible values for Function and Professions are:
  • accountancy-jobs
    • financiele-vacatures-catchall
    • finance-trainee-jobs
    • financial-advisor-jobs
    • finance-employee-jobs
  • admin-jobs
    • administratieve-vacatures-catchall
    • administrator-jobs
    • back-office-employee-jobs
  • marketing-jobs
    • marketing-vacatures-catchall
    • communications-jobs
    • web-editor-jobs
    • marketing-jobs
  • advice-jobs
    • consultancy-vacatures-catchall
    • consultant-jobs
  • bar-staff-jobs
    • horeca-vacatures-catchall
    • catering-assistant-jobs
    • vacatures-horeca-medewerker
  • counselling-jobs
    • uiterlijke-verzorging-vacatures-catchall
  • customer-service-jobs
    • callcenter-vacatures-catchall
    • call-centre-staff-jobs
    • customer-service-jobs
    • help-desk-employee-jobs
    • webcare-employee-jobs
  • design-jobs
    • creatieve-vacatures-catchall
  • engineering-jobs
    • bouw-vacatures-catchall
  • medical-jobs
    • medische-vacatures-catchall
  • home-care-jobs
    • zorg-vacatures-catchall
    • nurse-jobs
    • domestic-care-jobs
    • home-care-jobs
  • hr-jobs
    • hr-vacatures-catchall
    • hr-employee-jobs
    • recruiter-jobs
    • payroll-manager-jobs
  • ict-jobs
    • ict-vacatures-catchall
    • app-developer-jobs
    • c-net-developer-jobs
    • front-end-developer-jobs
    • it-trainee-jobs
    • java-developer-jobs
    • php-developer-jobs
    • ruby-developer-jobs
    • software-developer-jobs
    • system-administrator-jobs
  • legal-jobs
    • juridische-vacatures-catchall
    • legal-assistant-jobs
  • logistics-jobs
    • logistieke-vacatures-catchall
    • vacatures-bijrijder
    • driver-jobs
    • forklift-driver-jobs
    • courier-jobs
    • logistics-jobs
    • warehouse-assistant-jobs
    • package-delivery-jobs
    • postman-jobs
    • truck-driver-jobs
    • orderpicker-jobs
    • transport-planner-jobs
    • controller-jobs
    • shipping-clerk-jobs
  • management-jobs
    • management-vacatures-catchall
    • manager-jobs
    • hr-manager-jobs
    • branch-manager-jobs
    • sales-manager-jobs
    • team-leader-jobs
    • supervisor-jobs
    • operations-manager-jobs
    • project-manager-jobs
  • manufacturing-jobs
    • productie-vacatures-catchall
    • production-assistant-jobs
  • online-marketing-jobs
    • online-Marketing-vacatures-catchall
    • digital-marketing-jobs
    • seo-specialist-jobs
  • project-management-jobs
    • projectmanagement-vacatures-catchall
  • promotion-jobs
    • promotiewerk-vacatures-catchall
    • hostess-jobs
    • promotional-staff-jobs
  • receptionist-jobs
    • receptioniste-vacatures-catchall
  • retail-jobs
    • winkel-vacatures-catchall
    • shop-assistant-jobs
    • cashier-jobs
    • vacatures-vakkenvuller
  • sales-jobs
    • sales-vacatures-catchall
    • commercial-assistant-jobs
    • sales-representative-jobs
    • account-manager-jobs
  • science-jobs
    • chemische-vacatures-catchall
  • secretary-jobs
    • secretariele-vacatures-catchall
    • vacatures-receptioniste
    • secretary-jobs
    • telephone-operator-jobs
  • security-jobs
    • beveiliging-vacatures-catchall
  • sport-jobs
    • toerisme-vacatures-catchall
  • teaching-jobs
    • onderwijs-vacatures-catchall
    • teaching-jobs
  • technical-jobs
    • electra-vacatures-catchall
  • training-jobs
    • trainer-vacatures-catchall
<education_types>, Mandatory
List of <education_type> elements which contains the education type that are associated with this vacancy. At most one specified per <education_type> element. Possible values are:
  • college
  • other
  • secondary school
  • university
<languages>
List of <language> elements which contains the languages that are required for this vacancy. Possible values are:
  • arabic
  • chinese
  • czech
  • danish
  • dutch
  • english
  • finnish
  • flemish
  • french
  • german
  • greek
  • hebrew
  • italian
  • japanese
  • korean
  • latin
  • norwegian
  • other
  • polish
  • portuguese
  • russian
  • spanish
  • swedish
  • taiwanese
  • turkish
  • welsh
<salary>
The salary that will be paid for this vacancy.
<currency>
Possible currencies: €, £, SEK, CHF
<min>, Mandatory if you wish to add salary
The minimum salary for this vacancy.
<max>
The maximum salary for this vacancy.
<salary_rate>
The rate at which the amounts are considered: per hour, per week, per month, per year
<drivers_license>
A flag that says if the candidate is required to have a drivers license. Must be a boolean.