what:where:

Why should you get your job ads on Jora?

We are currently operating in 36 countries (see the full list here). We are #1 job search website in Australia by number of ads and #3 by traffic and have a large volume of job ads and users in many other countries, too.

We operate across 3 platforms: desktop, mobile web and native mobile apps (Jora Jobs on iOS and Android with strong traffic growth).

End-user features include:

  • simple and intuitive job search
  • email alerts and push notifications on new job ads
  • saved searches
  • saved jobs
  • quick apply

Jora is partnering with main job boards around the world to deliver more opportunities for job seekers.

On the hirers’ side, we offer a free job ads posting facility and have a number of unique job ads in most countries.

Benefits of feed integration on Jora

When your feed is integrated on Jora, you gain a trouble-free traffic source and as a consequence, additional applications from candidates. You keep the ownership of the application process since we redirect users to apply on your site.

While we can also crawl websites to integrate your job ads, an XML or JSON feed offers a much more reliable and faster way of getting your job ads published on Jora.

The best part of it? This integration is FREE.

XML format

Here is the XML standard: https://www.w3schools.com/xml/xml_syntax.asp

The feed must namely respect the following two rules:

  • xml document must have a root element (e.g. <jobs>)
  • xml elements must be properly nested (e.g. <jobs><job>...</job></jobs>)

Additional rules:

  • Zip and gzip files are accepted
  • No RSS feeds
  • Please include formatting in your job description (see below)

File encoding

We accept XML feeds encoded in Unicode. Please include the encoding of the content data in the XML declaration.

Job description formatting

To render job description properly, it must be formatted in HTML in the original feed. Your job descriptions should not be a flat block of text or text using newlines but should include HTML formatting tags like the below in their job description:

  • div
  • ul
  • li
  • p
  • br

You can also use heading tags like strong, h1, h2, etc.

CDATA

Jora accepts XML files both with and without CDATA sections.

If CDATA sections are not used, please make sure that the content of the XML tags is properly escaped.

Left angle brackets and ampersands may not occur in their literal form and must be escaped using "<" and " &".

XML structure

This section describes the structure of a job advertisement XML file.

The root element is <jobs> and each ad should be enclosed in a <job> tag.

NB: Don’t duplicate the tags within the same job, e.g. don’t repeat <URL> twice.

Example:

The overall structure of the XML file is as follows:

<?xml version="1.0" encoding="UTF-8" ?>

<jobs>

<job>

...

</job>

<job>

...

</job>

</jobs>

...

Here is an example of an XML file structure:

<source>

<publisher>samplejobs.com</publisher>

https://www.samplejobs.com

<lastBuildDate>2018-12-04 00:00:00 UTC</lastBuildDate>

<job>

<title>

<![CDATA[ Baristas - Monday to Friday. ]]>

</title>

<url>

</url>

<id>

<![CDATA[ 2550886 ]]>

</id>

<listed_date>

<![CDATA[ Mon, 4 Sep 2018 01:33:48 EDT ]]>

</listed_date>

<closing_date>

<![CDATA[ 10/12/2018 ]]>

</closing_date>

<source>

<![CDATA[ Heaven Coffee Roasters ]]>

</source>

<location>

<![CDATA[ Docklands, Melbourne, Victoria, Australia ]]>

</location>

<city>

<![CDATA[ Melbourne ]]>

</city>

<state>

<![CDATA[ Victoria ]]>

</state>

<postcode>3000</postcode>

<country>

<![CDATA[ Australia ]]>

</country>

<description>

<![CDATA[

<b>About our company:</b> We are the longest established coffee roasters in the Melbourne CBD. <br><br><b>About you:</b> We pride ourselves on our dedicated team of highly trained coffee experts.<b>The job:</b> As one of three baristas working our state-of-the-art coffee machines you will be the life and soul of Dukes and get to know the hundreds of regulars who have been with us for many years. You will have at least two years experience, a passion for coffee, a flair to upsell the right food items and thrive in a fast-paced environment<br><br><b>How to apply:</b>Click on the link to send us a cover letter and a brief CV.

]]>

</description>

<salary>

<type>hourly</type>

<min>18.50</min>

<max>24.00</max>

<currency>AUD</currency>

<additionalText>Award rates</additionalText>

</salary>

<jobtype>

<![CDATA[ Full Time ]]>

</jobtype>

<url>

<![CDATA[

https://www.samplejobs.com/jobs/2550886-baristas.html

]]>

</url>

</job>

<job> ....

</job>

</source>

Please refer to the following table for full feed specifications:

XML tag

Type

Description

title

mandatory

Job title. This should be an actual job title and should ideally not include a location, salary, ID number or any superfluous words that may interfere with retrieving the job during a job search.
id

mandatory

Unique identifier of the ad from the original job ad. Jora will use this to uniquely identify ads in the Jora database.
Do not re-use the same id numbers on later ads as they will be considered to have been already published and therefore will not be shown.
description

mandatory

Description of the job with the formatting HTML tags included (see below)
url

mandatory

URL of the job from the original site, this must be a unique URL redirecting the user to a job description with the ability to apply online for the job.
Tracking parameters (e.g. utm_source=jora) can be included in the original XML or requested to be appended by Jora.
location

mandatory

The place where the job is located.
We can accept "raw" locations like "10 Elizabeth St, Melbourne Victoria Australia ", "Melbourne VIC ", "Melbourne ". Ideally this should only include one value which should be the closest suburb, town or city to the job. This allows us to accurately map the job to the most relevant location in our database. If multiple locations appear within one tag then we will only use the first location supplied.
city optional If the location is a suburb of a larger city, you can include the city name.
state optional The state or region of the country for the location. This can be critical because many location names may occur in multiple states (hononyms) so the state is needed to correctly resolve the location.
postcode optional If the postcode or zip code of the ad is available, then having it in a separate XML tag is highly preferable.
country optional Country the job is located in.
ISO_3166-1 country codes are highly preferable. If custom country identifiers are supplied ("UK", "United Kingdom") they must be used consistently throughout the file. Mixing different custom country identifiers for the same country will produce very poor results.
Jora operates in 36 countries (see the full list here). We are only able to publish jobs located in these countries.
job_type highly preferable Examples of accepted values (you can provide more than one job type separated by comma, e.g. full time, permanent):
  • Full time
  • Part time
  • Casual/Temporary
  • Contract
  • Permanent
  • Volunteer
  • Fly In Fly Out
  • Internship
  • Apprenticeship
  • Freelance
  • Working holiday
NB: If this data is not provided, then Jora may be unable to surface your jobs to our users when they search using these filters on Jora.
listed_date highly preferable The date when the job was first published. We accept ISO 8601 standard formatted dates (cf https://en.wikipedia.org/wiki/ISO_8601)
closing_date highly preferable The date when applications for the job will close, in ISO 8601 standard.
Note that jobs that have an application date in the past will not be published.
salary highly preferable The ideal structure of the salary section is as follows:
<salary>
<type>One of: hourly|daily|weekly|monthly|yearly</type>
<min>100000</min>
<max>200000</max>
<currency>AUD</currency>
<additionalText>any commission information</additionalText>
</salary>

N.B. numbers should be formatted in ISO (no thousand delimiters, . (dot) as decimal point
N.B. currency is in ISO format
NB: For Australian jobs, if no salary is provided, Jora will estimate a salary using a salary prediction model.
source highly preferable The employer for the job ad - usually the name of a company. Recruitment agencies or job site names should not be included.


XML Feed Hosting

You will have to cater for the feed hosting. Jora can work with any of the following hosting solutions:

  • S3 (Amazon)
  • HTTP
  • FTP

If you already integrate with a ATS who hosts your jobs, please get in touch to discuss further.

Feed content requirements

There are some criteria that advertised jobs must meet in order to be published on Jora:

  • A clear location for the work;
  • A clear job title and description which describes the true nature of the work;
  • Clear working hours (one only of: full-time, part-time, casual, temporary);
  • A clear closing date for the job;
  • It is clear who the employer is;
  • The advertisement is a true position paid working for an employer and not a franchise opportunity, training or certification scheme, business opportunity, marketing scheme or self-employment of contractors. We do not accept 'work from home' / 'self employment' model sites advertising the opportunity to join their database rather than actual jobs.
  • The jobs included in your feed should be unique, posted directly on your platform, not copied from another source and not redirecting to a third party website.

Tracking parameters

Jora provides UTM tracking parameters. Please get in touch if you have specific requirements.

Feed update frequency and removal of expired ads

Jora can crawl your feed and add new ads at a set frequency between every 2 hours and every 24 hours, depending on the number of job ads and how often they get updated on your side.

We remove expired jobs from Jora live sites after they are removed from your feed. Please note they must be actually removed from the feed, not marked as ‘filled’ or ‘deleted’.

We can also remove the ads based on expiry date if it is provided.

If there is no expiry date provided, we expire the ads 60 days after they were posted.

We don't publish permanently open positions as we wish to make sure jobseekers using Jora sites have access to genuine and up-to-date job openings where they have a good chance to actually get a job.

Communication along the way

For technical questions regarding your feed, please contact support@jora.com

For any commercial questions, please contact sales@jora.com.

If you plan to update your feed, change your sponsoring strategy or have any questions at all, please get in touch.