XML Documentation

Introduction

HerFuture can automatically import your vacancies via an XML feed. Below you will find the specification that the XML must meet.

Example

<?xml version="1.0" encoding="UTF-8"?>
<jobs>
  <job>
    <id><![CDATA[REQ-1001]]></id>
    <title><![CDATA[Junior Java Developer]]></title>
    <category><![CDATA[full-time]]></category>
    <location><![CDATA[Amsterdam]]></location>
    <description><![CDATA[Build scalable APIs in Java and Spring Boot.]]></description>
    <education><![CDATA[HBO, WO - Bachelor]]></education>
    <languages><![CDATA[EN, NL]]></languages>

    <!-- optional -->
    <experience><![CDATA[zero-to-two]]></experience>
    <salary_min><![CDATA[2500]]></salary_min>
    <salary_max><![CDATA[3000]]></salary_max>
    <salary_currency><![CDATA[EUR]]></salary_currency>
    <application_closing_date><![CDATA[2026-09-30]]></application_closing_date>
    <apply_url><![CDATA[https://example.com/careers/1001]]></apply_url>
  </job>
</jobs>

XML tag specification

Tag

Description

Type

Mandatory?

Example

id

Unique job id

String

Yes

<![CDATA[1234]]>

title

Job title

String

Yes

<![CDATA[Junior Software Engineer]]>

category

Job category

String, internship, traineeship, full-time, part-time

Yes; if not provided (correctly), defaults to full-time

<![CDATA[internship]]>

education

Education level

Comma-delimited list of education levels

HBO, WO - Bachelor, WO - Master

Yes; if not provided (correctly), defaults to WO - Bachelor

<![CDATA[HBO, WO - Bachelor]]>

salary_min

Monthly MIN salary in EUR

String

No

<![CDATA[2500]]>

salary_max

Monthly MAX salary in EUR

String

No

<![CDATA[3000]]>

location

Location (city) of the job

String

Yes

<![CDATA[Amsterdam]]>

description

Job description

String (HTML support coming soon)

Yes

<![CDATA[We are lookign for a Junior Software Engineer.]]

languages

Required languages for the job

Comma separated languages codes

EN, NL, etc.

Yes; minimum 1 is required

<![CDATA[EN, NL]]>

HerFuture on the go