Job Feed
XML-Jobfeed
The XML-Feed is used to publish jobs to 3rd-Party applications, where the feed contains a list of jobs.
<jobs> <job> <id>12345</id> <name>recruiter</name> <subTitle>with professional experience</subTitle> <companyDescription><![CDATA[description of the company]]></companyDescription> <location>Vienna</location> <description><![CDATA[description of the job]]></description> <requirements><![CDATA[job requierements]]></requirements> <additionalText><![CDATA[addtional jobtext]]></additionalText> <responsibleUser>epunkt admin</responsibleUser> <responsibleEmail>support@erecruiter.net</responsibleEmail> <responsibleGender>1</responsibleGender> <jobProfile>Accounting</jobProfile> <url>http://pres.epunkt.com/Jobs/Job?Job=12345&Referrer=pres.epunkt.net</url> <applyUrl>http://pres.epunkt.com/?Job=12345&Referrer=pres.epunkt.net</applyUrl> <content><![CDATA[CSS & HTML of the job]]></content> <dateSinceOnline>2016-03-25T00:00:00</dateSinceOnline> </job> <!-- More jobs --> </jobs>
XML-Jobfeed Tags
Find a description of the available XML-tags in the next table<tag_name> | description | example |
|---|---|---|
| job ad metadata | ||
id | The ID of the job | 12345 |
name | The name of the job | Software Developer |
subTitle | The subtitle of the job | for Online Gaming Solutions |
companyDescription | The description of the company | Our client is an international Software Development Center, newly established … |
description | The job description | The software developer is a hands-on technical person who will be responsible for … |
requirements | The job requirements | The ideal candidate is a professional with experience in … |
additionalText | Addtional jobtext | Our client offers the possibility to … |
| footer | Optional footer job text | |
| content | The full css and html markup of the jobad | <style type="text/css"> #jobAd { font-family: Univers… |
| contact information for the recruiter | ||
responsibleUser | The person, who is responsible for the job (i.e. the Recruiter) | John Smith |
responsibleEmail | Email address of the responsible person | |
responsibleGender | Gender of the responsible person | 0 or 1 [0=female][1=male] |
jobProfile | The job profile (just one entry possible) | IT |
| callback URLs for applications | ||
url | The URL of this job | http://jobs.webpage.com/Jobs/Job?Job=12345&Referrer=www.webpage.com |
applyUrl | Application link | |
| job ad time information | ||
dateOfCreation | The creation date of the job | 2016-06-11T14:43:09.883 |
dateOfUpdate | The date of the latest job update | 2016-06-11T14:52:21.077 |
dateSinceOnline | The date since the job is online available | 2016-06-11T14:52:20.937 |
dateSinceOnlineCorrected | Corrected date since the job is online | 2016-06-11T00:00:00 |
| job ad additional information | ||
occupationType | Type of employment | Part time / Full time / … |
careerLevel | Career level | Experienced (Non-Manager) |
| job ad general location information | ||
| region | The region just like states or counties | Germany |
| location | The city of employment | Berlin |
| geoKoordinate | The location of the job as geo coordinates | |
| job tags | ||
| tag | Tag (free text, multiple tags possible) | IT, Gaming,… |
| job ad publication channels | ||
| publishedOn | A list of portals and channels where the job is published on | Stepstone, Karriere.at,.. |
| multi-posting providers channel information | ||
| multiChannelProviders | A list of multi-channel provider configured channels | |
| extended job location information for multi-posting providers | ||
| jobCountry | The country of the job | Austria |
| jobZipCode | The zip code of the job | 4020 Linz |
XML-Jobfeed Request URL's
There are some routes available on the applicant-portal to generate different kind of feeds. These routes follows the following pattern
(http|https)://my.portal.url/Syndication/{format}?parameter1=value1¶meter2=value2&...
Find next a description of the routes with their specific parameters
Syndication/Xml
Generates a XML with a list of jobs of the specified publication channel. If no publication channel is specified but a referrer, then the referrer is taken as channel, if it is a valid channel. If neither of both is specified, the current URL is used as channel. Optionally it's possible to filter the list of jobs by applying filters in parameters 'filter', 'jobProfiles' and 'regions'.
A XML with all jobs of the specified publication channel and filtered by the optional filter parameters is returned.
Find a description of the URL-parameters next.
| parameter | description |
|---|---|
| channel | The publication channel or portal URL, if no channel is supplied, the default publication channel is used |
| filter | A string with a filter to filter the published jobs of the specified channel parameter |
| format | Specifies the format how the job ad should be displayed. If "html" is supplied the job ad html of the job is used, else a default job ad is generated |
| jobProfiles | A list of job profiles splitted by the character '|' to filter the published jobs |
| multiPostingPartner | Filter for a specific multi-posting partner |
| referrer | The referrer is appended to each job URL in the resulting XML. It was used as channel in earlier times where the channel didn't exist |
| regions | A list of regions splitted by the character '|' to filter the published jobs |
| culture | The culture the jobs should be rendered for |
Syndication/Rss
Generates an Rss-Feed result from the parameters specified.
| parameter | description |
|---|---|
| channel | The publication channel or portal URL, if no channel is supplied, the default publication channel is used |
| referrer | The referrer is appended to each job URL in the resulting XML. It was used as channel in earlier times where the channel didn't exist |
| filter | A string with a filter to filter the published jobs of the specified channel parameter |
| jobProfiles | A list of job profiles splitted by the character '|' to filter the published jobs |
| regions | A list of regions splitted by the character '|' to filter the published jobs |
| format | A string with a filter to filter the published jobs of the specified channel parameter |
| culture | The culture the jobs should be rendered for |
Syndication/Xml/All
Load all published jobs in a chronological descending order from the specified channel, if specified. If no channel is supplied, jobs are loaded from the current portal. Optionally it's possible to filter the list of jobs by applying filters in parameters 'filter', 'jobProfiles' and 'regions'.
A list of jobs of the specified publication channel and filtered by the optional filter parameters is returned.
Find a description of the URL-parameters next.
| parameter | description |
|---|---|
| referrer | The referrer is appended to each job URL in the resulting XML |
| filter | A string with a filter to filter the published jobs |
| jobProfiles | A list of job profiles splitted by the character '|' to filter the published jobs |
| regions | A list of regions splitted by the character '|' to filter the published jobs |
| format | Specifies the format how the job ad should be displayed. If "html" is supplied the job ad html of the job is used, else a default job ad is generated |
| multiPostingPartner | Filter for a specific multi-posting partner |
| culture | The culture the jobs should be rendered for |
XML-Schema
FAQ
There are 4 different ways for each language to send a XML-Feed
Settings in eRecruiter which influences the feed
- CUSTOM-Fields
- Public custom fields for jobs and customers are published via the XML feed to the applicant portal.
- Portal Settings
- You can choose:
- include Advanced Data
include tagsinclude 4th job text block