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>356276</id>
    <url>https://www.studentjob.es/ofertas/356276-online-marketing-internship</url>
    <title>Online Marketing Internship</title>
    <function_title>Online Marketeer</function_title>
    <responsibilities>Creating and writing content to increase the visibility of our website. </responsibilities>
    <location>
      <nationwide/>
      <city>Madrid</city>
      <postalcode>28070</postalcode>
    </location>
    <description>
      <summary>
        <![CDATA[Are you looking for a challenge abroad ? Then join our StudentJob International division in Hoofddorp (15 min from Amsterdam). During your content marketing internship, you will definitely learn a lot!]]>
      </summary>
      <long_description>
        <![CDATA[<p>StudentJob International is operating in many
European countries. We strive to be the ultimate online job portal for students
benefiting both students and companies with regards to recruitment for
temporary/full-time jobs, internships, placements and graduate jobs. Your role
will be essential in implementing effective marketing strategies to contribute
to our success!</p><p class="MsoNormal" style="margin-bottom:0cm;margin-bottom:.0001pt;line-height:
normal"><span lang="EN-GB"><o:p> </o:p></span></p><p class="MsoNormal" style="margin-bottom: 11.25pt; line-height: normal; background-image: initial; background-color: white;" rel="margin-bottom: 11.25pt; line-height: normal; background-image: initial; background-color: white;"><strong><span lang="EN-GB">What’s in it for me?</span></strong><span lang="EN-GB"><o:p></o:p></span></p><ul type="disc">
 <li class="MsoNormal"><span lang="EN-GB">An innovative, friendly, and young office –
     there is always time and space for relaxing and socializing!<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">A challenging, diversifying and independent
     placement surrounded by +/- 35-40 international colleagues <o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Online marketing team consists of 8 other
     interns from all over Europe, led by an experienced digital marketer who
     will train and help you. <o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Trainings on SEO, Google Analytics,
     Facebook ads / Adwords, reporting, online marketing as a whole, conversion
     rate optimization. <o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">A competitive European placement salary
     (€550) & reimbursement of travel expenses (Max. €200 per month)<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Possibility of an Erasmus grant (+/- €350
     p/month)<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Bonus system to earn extra days off (per 6
     months: 4 days off guaranteed– 6 more to earn!)<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Free lunch, snacks and all the coffee you
     can drink (and free beer on Friday afternoons)<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Ping-Pong tournaments, boat trips and much
     more!<o:p></o:p></span></li>
</ul><p class="MsoNormal" style="margin-bottom: 11.25pt; line-height: normal; background-image: initial; background-color: white;"><strong><span lang="EN-GB">What will I be expected to do?</span></strong><span lang="EN-GB"><o:p></o:p></span></p><ul type="disc">
 <li class="MsoNormal"><span lang="EN-GB">You will manage the StudentJob.es website, attracting students and employers to register.<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Your focus will be on SEO & referral
     partners, meaning you’ll spend a lot of time writing / optimizing content
     on our website and contacting partners to start or improve cooperations.<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You’ll analyze the performance of the
     website using Google Analytics and other tools.<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You’ll be in charge of our social media
     presence on Facebook, Twitter and Instagram.  <o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You’ll respond to all clients, from big
     name companies to students.<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You’ll support the Spanish sales team by for
     example gathering website data used for sales purposes (you’re not expected
     to do any sales tasks yourself)<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">We really appreciate you bringing in new
     ideas!<o:p></o:p></span></li>
</ul><p class="MsoNormal" style="line-height: normal; background-image: initial; background-color: white;"><strong>Job Requirements: </strong><o:p></o:p></p><ul type="disc">
 <li class="MsoNormal"><span lang="EN-GB">You’re currently studying at a Spanish University or Business School<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You’re preferably studying International
     Business/Marketing/Communication.<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">Your native tongue is Spanish<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You enjoy writing texts and working with
     numbers / data<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You’re interested in international business
     and online marketing.<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You are available from December 2017 / January 2018 and
     you can stay for 5 to 12 months.<o:p></o:p></span></li>
 <li class="MsoNormal"><span lang="EN-GB">You have the right to live, work and study
     in Europe.<o:p></o:p></span></li>
</ul><p class="MsoNormal" style="margin-bottom: 11.25pt; line-height: normal; background-image: initial; background-color: white;"><span lang="EN-GB">Interested in this challenging and diverse placement where you’ll get lots
of responsibility? <br>
Click<strong> Apply Now</strong> and send us your application.<o:p></o:p></span></p><p>We look forward to hearing from you!</p>]]>
      </long_description>
    </description>
    <hours_per_week>
      <working_hours_min>32</working_hours_min>
      <working_hours_max>40</working_hours_max>
    </hours_per_week>
    <job_types>
      <job_type>graduation_internship</job_type>
      <job_type>traineeship</job_type>
    </job_types>
    <functions>
      <function>
        <reference>trabajo-marketing</reference>
        <professions>
          <profession>ofertas-responsables-marketing</profession>
        </professions>
      </function>
      <function>
        <reference>trabajo-marketing-digital</reference>
        <professions>
          <profession>ofertas-online-marketing</profession>
        </professions>
      </function>
    </functions>
    <education_types>
      <education_type>universidad</education_type>
      <education_type>máster</education_type>
    </education_types>
    <languages>
      <language>english</language>
      <language>spanish</language>
    </languages>
    <salary>
      <currency>€</currency>
      <min>550.0</min>
      <max/>
      <salary_rate>2</salary_rate>
    </salary>
    <drivers_license>false</drivers_license>
  </job>
  <job>
    <id>394331</id>
    <url>https://www.studentjob.es/ofertas/394331-profesor-a-particular-para-multiples-disciplinas</url>
    <title>Profesor/a particular para múltiples disciplinas</title>
    <function_title>Profesor</function_title>
    <responsibilities>Dar clases particulares</responsibilities>
    <location>
      <nationwide/>
      <city>Madrid</city>
      <postalcode>28070</postalcode>
    </location>
    <description>
      <summary>
        <![CDATA[Superprof, plataforma N°1 que pone en contacto a profesores/as particulares y a alumnos/as en España, busca docentes durante todo el año en todo el territorio nacional para dar clases particulares en distintos ámbitos: asignaturas académicas, idiomas, música, canto, deportes, ocio…]]>
      </summary>
      <long_description>
        <![CDATA[<p><strong>Misión</strong>:</p><p><span></span>Superprof, plataforma n°1 que pone en contacto a profesores/as particulares y a alumnos/as en España, busca docentes durante todo el año en todo el territorio nacional para dar clases particulares en distintos ámbitos: asignaturas académicas, idiomas, música, canto, deportes, ocio…</p><p><span></span><strong>Ventajas</strong>:</p><ul><li>Inscripción totalmente gratis</li><li><span></span>Remuneración atractiva, neta y sin sorpresas (no cobramos comisión)</li><li><span></span>Gestión de tu propio tiempo</li><li><span></span>Multitud de alumnos/as: más de 15 000 búsquedas diarias</li><li><span></span>Posibilidad de dar clases por webcam</li></ul><p><strong>Lugares</strong>:</p><ul><li>Cerca de tu domicilio: en tu casa o en la del alumno/a</li></ul><p><strong>Perfil</strong>:</p><ul><li>¿Has superado la PAU como mínimo?</li><li><span></span>¿Deseas transmitir tus conocimientos, tu pasión y tu saber a tus alumnos/as?</li><li><span></span>¿Eres paciente, puntual y pedagógico/a?</li><li><span></span>¿Piensas, como nuestro equipo, que todo el mundo tiene algo que enseñar y que aprender?</li></ul><p>Si la respuesta es sí, es hora de que te unas a nuestro equipo para dar clases particulares.</p><p><strong>Horarios</strong>:<br></p><p>Según tu disponibilidad. Demanda durante todo el año.<br></p><p><strong>Remuneración</strong>:</p><p><span></span>En función de tu perfil.</p>]]>
      </long_description>
    </description>
    <hours_per_week>
      <working_hours_min>10</working_hours_min>
      <working_hours_max>32</working_hours_max>
    </hours_per_week>
    <job_types>
      <job_type>weekend</job_type>
      <job_type>holiday</job_type>
      <job_type>internship</job_type>
    </job_types>
    <functions>
      <function>
        <reference>trabajo-educacion</reference>
        <professions>
          <profession>ofertas-profesor</profession>
        </professions>
      </function>
    </functions>
    <education_types>
      <education_type>e.s.o</education_type>
      <education_type>bachillerato</education_type>
      <education_type>módulo de grado medio</education_type>
      <education_type>módulo de grado superior</education_type>
      <education_type>universidad</education_type>
      <education_type>máster</education_type>
      <education_type>otros</education_type>
    </education_types>
    <languages>
      <language>spanish</language>
    </languages>
    <salary>
      <currency>€</currency>
      <min>10.0</min>
      <max>30.0</max>
      <salary_rate>0</salary_rate>
    </salary>
    <drivers_license>false</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:
  • fulltime_temporary
  • weekend
  • parttime
  • traineeship
  • graduation_internship
  • fulltime
  • holiday
  • internship
  • evening
  • fulltime_experience
  • voluntary
<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:
  • trabajo-administracion
    • trabajo-administracion-catchall
    • ofertas-trabajo-administrativo
    • vacatures-backoffice-medewerker
  • trabajo-agricultura
    • trabajo-agricultura-catchall
  • trabajo-asesoria
    • trabajo-asesoria-catchall
    • ofertas-asistente-juridico
  • trabajo-atencion-al-cliente
    • trabajo-atencion-al-cliente-catchall
    • ofertas-teleoperadora
    • ofertas-servicio-clientes
    • ofertas-helpdesk
    • ofertas-servicio-online
  • trabajo-a-domicilio
    • trabajo-a-domicilio-catchall
    • ofertas-enfermera-privada
    • ofertas-cuidador
    • vacatures-huishoudelijke-hulp
  • trabajo-cajero
    • trabajo-cajero-catchall
    • ofertas-dependientes
    • ofertas-cajero
    • vacatures-vakkenvuller
  • trabajo-camarero
    • trabajo-camarero-catchall
    • ofertas-asistente-catering
    • ofertas-asistentes-horeca
  • trabajo-comercial
    • verkoop-vacatures-catchall
  • trabajo-diseno
    • trabajo-diseño-grafico-catchall
  • trabajo-esteticista
    • trabajo-esteticistas-catchall
  • trabajo-ingenieria
    • trabajo-electronico-catchall
  • trabajo-jefe-de-equipo
    • trabajo-jefe-de-equipo-catchall
    • ofertas-gerentes
    • ofertas-director-rrhh
    • ofertas-gerente-sucursal-
    • ofertas-jefe-de-ventas
    • ofertas-jefe-de-equipo
    • vacatures-supervisor
    • ofertas-director-de-operaciones
    • ofertas-jefe-de-proyecto
  • trabajo-logistica
    • trabajo-logistica-catchall
    • vacatures-bijrijder
    • ofertas-chofer
    • vacatures-heftruckchauffeur
    • vacatures-koerier
    • ofertas-especialistas-logistica
    • vacatures-magazijnmedewerker
    • ofertas-repartidor
    • ofertas-de-cartero
    • ofertas-de-camionero
    • ofertas-preparacion-pedidos
    • vacatures-transportplanner
    • vacatures-eindcontroleur
    • vacatures-expeditiemedewerker
  • trabajo-marketing
    • trabajo-marketing-catchall
    • ofertas-responsable-comunicacion
    • ofertas-redactores-web
    • ofertas-responsables-marketing
  • trabajo-marketing-digital
    • trabajo-redactor-catchall
    • ofertas-online-marketing
    • ofertas-especialista-seo
  • trabajo-salud
    • trabajo-salud-catchall
  • trabajo-editorial
    • trabajo-editorial-catchall
  • trabajo-peon
    • trabajo-peon-catchall
    • ofertas-limpiador
    • vacatures-operator
    • ofertas-cuidado-instalaciones
  • trabajo-cultura
    • trabajo-cultura-catchall
  • trabajo-operario
    • trabajo-metal-catchall
    • vacatures-automonteur
    • vacatures-technische-dienst
    • vacatures-monteur
  • trabajo-eventos
    • trabajo-eventos-catchall
    • ofertas-azafatos
    • ofertas-personal-promocion
  • trabajo-recursos-humanos
    • trabajo-entrevistador-catchall
    • vacatures-hr-medewerker
    • ofertas-reclutador
    • vacatures-salarisadministrateur
  • trabajo-seguridad
    • trabajo-seguridad-catchall
  • trabajo-consultoria
    • trabajo-consultoria-catchall
    • ofertas-desarrollador-aplicaciones
    • vacatures-c-net-developer
    • desarrollador-front-end
    • vacatures-it-trainee
    • ofertas-desarrollador-java
    • ofertas-desarrolladores-php
    • ofertas-desarrolladores-ruby
    • ofertas-desarrollador-software
    • vacatures-systeembeheerder
  • trabajo-finanzas
    • trabajo-finanzas-catchall
    • ofertas-asistente-financiero
    • ofertas-asesor-financiero
    • ofertas-responsables-finanzas
  • trabajo-educacion
    • trabajo-clases-particulares-catchall
    • ofertas-profesor
<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:
  • bachillerato
  • e.s.o
  • máster
  • módulo de grado medio
  • módulo de grado superior
  • otros
  • universidad
<languages>
List of <language> elements which contains the languages that are required for this vacancy. Possible values are:
  • german
  • arabic
  • korean
  • danish
  • french
  • galician
  • hebrew
  • japanese
  • polish
  • portuguese
  • catalan
  • czech
  • chinese
  • spanish
  • finnish
  • flemish
  • greek
  • dutch
  • english
  • italian
  • latin
  • norwegian
  • other
  • russian
  • swedish
  • taiwanese
  • turkish
  • valencian
  • basque
  • sign_language
<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.