Get your jobs published on Jora with an XML feed
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.
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.
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.
- xml elements must be properly nested (e.g.
- Zip and gzip files are accepted
- No RSS feeds
- Please include formatting in your job description (see below)
We accept XML feeds encoded in Unicode. Please include the encoding of the content data in the XML declaration.
Please note, we are only accepting Html and DecimalCode, not Hex Code.
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:
You can also use heading tags like strong, h1, h2, etc.
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
This section describes the structure of a job advertisement XML file.
The root element is
<jobs> and each ad should be enclosed in a
NB: Don’t duplicate the tags within the same job, e.g. don’t repeat
See an example XML Schema for job feeds here.
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> <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:
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.
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 of the job with the formatting HTML tags included (see below)
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.
The place where the job is located. We can accept “raw” locations like
If the location is a suburb of a larger city, you can include the city name.
The state or region of the country for the location. This can be critical because many location names may occur in multiple states (homonyms) so the state is needed to correctly resolve the location.
If the postcode or zip code of the ad is available, then having it in a separate XML tag is highly preferable.
Country the job is located in. ISO_3166-1 country codes are highly preferable. If custom country identifiers are supplied (
Examples of accepted values (you can provide more than one job type separated by comma, e.g. full time, permanent):
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.
The date when the job was first published. We accept ISO 8601 standard formatted dates (cf https://en.wikipedia.org/wiki/ISO_8601)
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.
The ideal structure of the salary section is as follows:
N.B. numbers should be formatted in ISO (no thousand delimiters,
N.B. currency is in ISO format.
N.B. For Australian jobs, if no salary is provided, Jora will estimate a salary using a salary prediction model.
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)
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.
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 us.
For any commercial questions, please contact firstname.lastname@example.org.
If you plan to update your feed, change your sponsoring strategy or have any questions at all, please get in touch.