Introduction

The XML feed lists job information that will be displayed on Jobrapido. Jobrapido will read, interpret and export content from your XML feed in order to provide to job seekers a readable and efficient output of Job pages.
It is the fastest and most efficient way of acquiring your jobs.
Once you pass on the Feed URL, your jobs will be live on Jobrapido within 24sh.

Feed Acces protocols:
Pull-mode: we can download your feeds from your server via HTTP, HTTPS, FTP.

Feed Basic example:

The following example shows a basic XML feed containing one job.
<?xml version="1.0" encoding="utf-8"?>
<source>
<jobs>
	<job>
		<title><![CDATA[Customer Support Representastive]]></title>
		<location><![CDATA[Phoenix]]></location>
		<state><![CDATA[AZ]]></state>
		<country><![CDATA[US]]></country>
		<postalcode><![CDATA[85003]]></postalcode>
		<company><![CDATA[Company Examplel]]></company>
		<website><![CDATA[www.examplesite.com]]></website>
		<publishdate><![CDATA[19/10/2018]]></publishdate>
		<expirydate><![CDATA[19/12/2018]]></expirydate>
		<url><![CDATA[http://www.examplesite.com/viewjob.cfm?jobid=123456]]></url>		
		<email><![CDATA[example@examplemail.com]]></email>
		<description>
		<![CDATA[<p><strong>Customer Support Representative</strong><br><em>Introduction:</em>
		<br>At Company Example we work hard so
		our customers can play hard. We love what we do and because we have been 
		the market leader for over 40 years we want the very best 
		experts on our team.</p><p>Working for us certainly 
		isn't for the "shy and retiring", but it's 
		definitely for the passionate the daring and 
		the expert. All of our employees 
		are passionate about Company Example and act
		as our Brand Ambassadors and why wouldn't they 
		be, when our ultimate vision is to help every woman
		in the world feel like the sexiest woman in the world.</p>]]>
		</description>
		<reference_id><![CDATA[ad3456]]></reference_id>
		<salary><![CDATA[$50K per year]]></salary>
		<education><![CDATA[Bachelors]]></education>
		<jobtype><![CDATA[fulltime, parttime]]></jobtype>
		<category><![CDATA[Category1]]></category>
		<experience><![CDATA[5+ years]]></experience>       
	</job>
	<job>...</job>
	<job>...</job>
	<job>...</job>
</jobs>
</source>

Feed Elements:

The XML feed contains a set of job elements that are used for each job in the feed.
Element Required Description
<title> YES The title should reflect the role.
It has to be at least 3 characters.
It does not contain any claims but only specific job roles.
<location> YES The location must indicate the specific Town/City where the job is located.
It should not include the address details of the workplace.
If you have different job ads in different locations, you should add in the feed all <job> element per each location.
<state> YES The state in which this job is located.
Use the corresponding geographic designation such as province or region.
<country> YES The country in which this job is located.
<postalcode> NO The postal code in which this job is located.
<company> YES The company name to be displayed in Jobrapido search results.
This should reflect an individual unit, corporate or brand.
<website> YES The website name should reflect the Corporate Website Name, the website individual unit or the website brand. (www.website.com).
<publishdate> YES The publish date provided should indicate when the job was first published.
The publish date added in the feed must match the one present in the job description.
It should not be older than 2 months.
It should not be equal to the Expiry Date.
It should not be set in the future.
<expirydate> YES The expiry date provided should indicate when the job will expire.
It should not be set in the past (previous to the publish date).
It should not be equal to the Publish Date.
<url> YES The URL for the job listing on your site.
It should not be the application page.
It could include token to track clicks from Jobrapido.
The URL address should be in standard HTML format (http://........ or https://........ ).
<email> NO It should be the email address used to receive CVs.
It could be different from job ad to job ad.
It could be encrypted, but it should be anyway active.
<application_URL> NO It should redirect to the Application form page on your site.
<description> YES The body of your job ads must include the complete job details, with relevant Information of the job ad: Responsibilities of the role (the main activities that the candidate is going to do); Requirements ( Skills and expertise etc..). Company offers (Training, education, support, Type of contract, Working hours, Bonus, Benefits, Other)
The job ad must be in the native language of the country where it is published or alternatively in English.
The description details added in the feed must have formatting parameters. (Please check details at the paragraph "Formatting guidelines").
The information in the <description> needs to match the details on the <url> page.
<reference_id> YES It identifies the job advert.
it must be unique for each job advert.

Formatting Guidelines:

Include formatting in the TAG for description.
It will allow Jobrapido to format your job description in a readable way and give to users a professional and clear output of your job ads.

Example in the feed:
<description>
<![CDATA[<p><strong>Customer Support Representative</strong><br><em>Introduction:</em>
<br>At Company Example we work hard so
our customers can play hard. We love what we do and because we have been 
the market leader for over 40 years we want the very best 
experts on our team.</p><p>Working for us certainly 
isn't for the "shy and retiring", but it's 
definitely for the passionate the daring and 
the expert. All of our employees 
are passionate about Company Example and act
as our Brand Ambassadors and why wouldn't they 
be, when our ultimate vision is to help every woman
in the world feel like the sexiest woman in the world.</p>]]>
</description>
How it looks:

Customer Support Representative
Introduction:
At Company Example we work hard so our customers can play hard. We love what we do and because we have been the market leader for over 40 years we want the very best experts on our team.

Working for us certainly isn't for the "shy and retiring", but it's definitely for the passionate the daring and the expert. All of our employees are passionate about Company Example and actas our Brand Ambassadors and why wouldn't they be, when our ultimate vision is to help every woman in the world feel like the sexiest woman in the world.

Multiposter or Job Reposters:

Jobrapido supports feeds which can contain vacancies from different employers/recruiters (Mutliposter or Job Reposters).
In order to read and import all job advertisements correctly, in your feed you need to specify for each job advert: website, company, category

Automatic Dynamic Bid:

Jobrapido manages automatically CPCs/Bids added in the feed.
It is enough to add in the feed a specific Node referring to the CPC value.

  • The value added in the TAG is always a numerical value.
  • No text are allowed to be added as additional info.
  • The CPC node needs to be added to each advert present in the feed we are indexing.
  • We can set a minimum CPC value you agreed with your Sales accountant. To all clicks delivered with a lower CPC than the one agreed with Jobrapido , the minimum CPC will be applied automatically.

    • Common Issues:

    The following problems can cause Jobrapido to reject your XML feed.
    Our system automatically bounces the jobs that have invalid details.

    Issue Action
    Incomplete or empty job descriptions Include the complete text related to the job.
    All incomplete job adverts will not be included.
    Jobs in the feed that does not match the URL job details Provide in the feed all information for each job advert that must match what is shwon in the URL job details.
    All non-matching job adverts will not be included.
    Jobs that are scams or suspected scams Jobrapido works to exclude suspected scams. Ensure that positions are real job offers and have well-written descriptions.
    Obsolete Jobs Provide valid and existing Job adverts.
    All expired adverts will not be included.
    Changes format or TAG in the feed If you change the feed structure, or TAGs elements, please inform  Jobrapido promptly in order to allow our system to be up-to-date
    Title less than 3 characters Provide complete title of the job advert. No abbreviations.
    All job adverts with incomplete titles will not be included.
    Multiple adverts with same URL and/or Reference ID Provide unqiue URL and/or reference ID.
    If Jobrapido finds sames URLs/Reference IDs, all duplicates will not be included.
    Adverts without precise instructions to submit applications Provide clear instructions to apply to your job vacancies. Jobrapido will reject job adverts where candidates are not able to apply.
    Adverts requiring a registration fee to send the CV or to get more information about the job offer Allow candidates to apply easily to your job adverts without any subscription or any specific fee registration. Jobrapido will reject job adverts where candidates are asked to pay or to subscribe to apply.

    FAQs:

    What are the options for delivering the feed?
    Jobrapido accepts the following Feed Acces protocols:
    Pull-mode: we can download your feeds from your server via HTTP, HTTPS, FTP.

    Does Jobrapido accept Zip file?
    Yes, Jobrapido processes also Zip format.

    Does Jobrapido accept Json format?
    Yes, Jobrapido processes also Json feed. It is important that the all required elements are correctly added in the feed for each job advert.

    How often does Jobrapido index the XML feed?
    Jobrapido refreshes each XML feed 4 times per day by default. It could increase based on sponsoring needs.

    What happens if I have the same job in multiple countries?
    In order to allow Jobrapido to index your multiple country advert, you need to add in the feed the job advert for each country and specify for each one the <country> TAG.  Each advert needs to have a unique URL/reference ID.

    If I delete my Job in the feed, how does Jobrapido update my job offers?
    In order to be up-to-date with the expired ads or the ones not valid anymore, we ask you to choose one of these options:

    • Add the TAG <expiry date> in the feed for each job ad
    • Cancel the URL of the Job details: if a user clicks on the URL he/she must not see the job details anymore.
    Choosing one of these options, the Jobrapido system will keep your job ads up-to-date within 72 hours (by default) after the changes have been made in the feed.
    IMP: Please give us your technician’s name and contact details, he/ she will help us to understand how you manage expired ads and your feed.

    Can I add an additional element in the feed?
    Yes, you can add any additional elements that are not required by Jobrapido as long as the standard fields are present.
    Please inform always Jobrapido on the new TAG added and the purpose of the TAG.

    If I want to assign a specific CPC to my job adverts, what should I do?
    You can assign a specific CPC to your job advert in the feed.
    Please inform and coordinate always with your Sales Account Manager in Jobrapido in order to define a minimum and maximum CPC and the increase between them.

    When do I need to add email address or application URL?
    If your job adverts need to be indexed in Jobrapido by using Recruitrapido (Jobrapido pages), you need to add in the feed how you prefer to receive applications (via email or via your ATS). Jobrapido will link the email/application URL automatically.

    Get in touch!

    Feel free to write to Jobrapido if you have any doubt or you want to have more information.
    You will be contacted by our Premium Service Representative as soon as possible.