XML Feed
Specifications
01. Introduction
Providing us an XML feed is the most reliable and the fastest way to get your job
advertisements included to Joobleʼs index. You should provide us a URL, where
your XML feed is located. An XML feed should contain all of the current job ads
that were published on your website.
To index jobs from the XML feed, we use a web-crawler, which identifies itself as
'JoobleBot' or 'HTTP/1.1 JoobleBot (compatible; https://jooble.org/jooble-bot)'
JoobleBot crawls an XML feed at least once per 24 hours. The time and
frequency of crawling can be adjusted to your requirements.
02. XML Fеed Format
We strongly encourage you to specify the current encoding
of an XML feed in its header, for example:
<?xml version="1.0" encoding="utf-8"?>
All job content must be inside CDATA sections to avoid issues processing
your XML feed. An XML feed must contain one common tag.
Each job must be inside a separate tag; this tag must contain a single
"id" attribute, which must contain the unique job ID.
The <job> tag must contain the following tags
Required tags
<link> — the full URL of a job, where Jooble will forward users to. The link must lead
to a page with a complete job description.
<name> — job title.
<region> — list of regions/cities. Regions can be listed in a text format and separated
by any punctuation marks.
<description> — a complete job description, including HTML formatting.
Please note that we are able to index an XML feed that contains complete jobs
descriptions. If there are additional fields such as “job descriptionˮ, “candidatesʼ
requirementsˮ, “responsibilitiesˮ, “working conditionsˮ on a job page, they must be
included to the <description> tag. The content and the order of the <description>
element must match the content on the page to which the <link> element directs.
<pubdate> — original publication date of a job. Please specify the date in the
DD.MM.YYYY format.
<updated> * — last modification date of a job. By this, we mean the last time when the
original publication date of a job was updated, or when a job description was edited by
an employer. Please specify the date in the DD.MM.YYYY format.
<salary> ** — salary + currency. For example, "300$", "1500€" or "167£".
<company> ** — a company name, name of employer.
<expire> ** — date when a job gets expired. Please specify the date in the
DD.MM.YYYY format.
<jobtype> ** — type of a job. For example, full-time, part-time, contract, internship,
temporary.
Please note
Jooble can index only those jobs that were published less than 45 days ago of the date
when Jooble first indexed your XML feed. This rule applies to <updated> and <pubdate>
tags. If a job does NOT have <updated> and <pubdate> tags, then a job is valid within 45
days of the date when Jooble first indexes this job.
Please note
Adding the tags marked with ** are required if they are available on your website; they may
increase your jobsʼ rankings and volume of targeted traffic from Jooble to your website.
Optional Tags
<company_logo>* — a URL address of the company logotype
Please note
Requirements to the
Jooble can display a company logo on
the search results page. Logo Dimensions
If you want Jooble to display your
Height 15px
clientsʼ company logos, you must add a
<company_logo> tag with a URL Width 40px
address of the company logotype.
Recommended logo formats JPG, PNG, GIF
<email>* — an email address where applicant details for the specified vacancy should
be sent
Please note
If multiple emails are specified in the Example of specifying multiple
<email> tag, the applicant details will emails inside XML tag:
be sent to the first email by default. If
<email><![CDATA[
[email protected],
you would like to receive applicant
[email protected]]]></email>
details on all other emails, please let us
know
How to add tags for segmentation in the feed?
In order to make a segmentation in the feed, please add a
special tag (for instance, the tag “paidˮ) to the vacancies
which you would like to be promoted. In the code it is
<paid><!CDATATrue/paid>
How to add tags for promoted vacancies in the feed?
In order to add CPC bids in the feed, please add tags to
every vacancy, for example, <сpc><!CDATA0.3/cpc>
How to add tags for campaign budget in the feed?
To set a campaign budget in the feed, add a special tag (for instance, the tag "budget") to each
vacancy. All vacancies of a specific campaign should share a common unique tag for segmentation.
This allows the system to group these vacancies into one campaign with a defined budget. The budget
value must be the same for all vacancies within the campaign.
Tag example: <budget>525/budget>. Please specify the budget as a whole number: 50, 525, 25, etc.
In case you have any questions, feel free to contact us
at
[email protected] or contact directly your country manager.
Example of an XML Feed
<?xml version="1.0" encoding="utf-8"?>
<jobs>
<job id="1604354">
<link><![CDATA[http:</example.com/Handlers/DoRedirect.aspx?messageId=24929
9382]]></link>
<name><![CDATA[English Teacher]]></name>
<region><![CDATA[London, Derby]]></region>
<salary><![CDATA[£161/day]]></salary>
<description><![CDATA<<p>Teachers UK, a well-respected and experienced
education recruitment specialist, is currently looking for CVs from
candidates interested in securing <strong>long term</strong> or
<strong>permanent positions</strong> for the new academic
year.</p><p>Formed in <strong>1997</strong>, we have successfully built
and maintained a strong and loyal client base across
<strong>Derbyshire</strong>, <strong>Staffordshire</strong>,
<strong>Nottinghamshire</strong>, <strong>South Yorkshire</strong>,
<strong>Lincolnshire</strong>, and <strong>Leicestershire</strong>.
</p><p>We provide <strong>competitive compensation</strong>, including
<strong>stock options</strong> and a full <strong>benefit
plan</strong>.</p><p><strong>Join our winning team!</strong> <strong>Apply
Now!</strong></p>]]>
</description>
<company><![CDATA[BIG CORPORATION]]></company>
<company_logo><![CDATA[http:</example.com/logo/92775.png]]></company_logo>
<pubdate>11.07.2014</pubdate>
<updated>27.07.2014</updated>
<expire>03.09.2014</expire>
<jobtype>full-time</jobtype>
<email><![CDATA[
[email protected],
[email protected]]]></email>
</job>
</jobs>
