Thanks for your interest in our XING E-Recruiting Feed. This page serves as an implementation guide and technical documentation for importing your job ads into XING Jobs via a XML feed. It’s designed to help you get up and running quickly by outlining the most important steps.
First things first: Only XING customers with a valid contract are able to post job postings on XING via a feed. If you don’t have a contract yet, please e-mail e-recruiting-api@xing.com
To integrate your job postings via feed, please make sure your feed meets the following basic requirements:
The following will give you an overview of how data is collected and integration takes place:
This example feed consists of two valid job ads: A minimal one consisting only of mandatory fields and one full example with all available fields filled in. You can also download this example feed and its corresponding XSD schema definition. Please check out the schema for types, occurrence guidelines, and substructures.
<?xml version="1.0"?> <feed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://dev.xing.com/jobs/xsd"> <postings> <!-- Start basic example with mandatory fields --> <posting> <id>1</id> <job_title><![CDATA[Senior Sales Manager]]></job_title> <description> <![CDATA[ <h3>Company description</h3> <p>Lorem ipsum dolor sit consetetur sadipscing elitr, sed diam nonumy eirmod tempor.</p> <h3>Your responsibilities</h3> <ul> <li>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</li> <li>Sed diam nonumy eirmod tempor invidunt.</li> </ul> <h3>Your skills</h3> <ul> <li>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</li> <li>Sed diam nonumy eirmod tempor invidunt.</li> </ul> ]]> </description> <url><![CDATA[http://companyname.com/jobs/job1]]></url> <company_name><![CDATA[Companyname Inc.]]></company_name> <job_location> <city><![CDATA[Hamburg]]></city> <country><![CDATA[DE]]></country> </job_location> </posting> <!-- End basic example --> <!-- Start full example --> <posting> <id>213231RB</id> <job_title><![CDATA[Senior Sales Manager]]></job_title> <description> <![CDATA[ <h3>Company description</h3> <p>Lorem ipsum dolor sit consetetur sadipscing elitr, sed diam nonumy eirmod tempor.</p> <h3>Your responsibilities</h3> <ul> <li>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</li> <li>Sed diam nonumy eirmod tempor invidunt.</li> </ul> <h3>Your skills</h3> <ul> <li>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</li> <li>Sed diam nonumy eirmod tempor invidunt.</li> </ul> ]]> </description> <url><![CDATA[http://companyname.com/jobs/job1]]></url> <company_name><![CDATA[Companyname Inc.]]></company_name> <company_profile_url><![CDATA[https://www.xing.com/companies/deutschetelekomag]]></company_profile_url> <publish_to_company_profile>true</publish_to_company_profile> <job_location> <address><![CDATA[Dammtorstraße 30]]></address> <city><![CDATA[Hamburg]]></city> <zip_code>08470</zip_code> <country><![CDATA[DE]]></country> <latitude>23.1112</latitude> <longitude>41.220</longitude> </job_location> <contact_email><![CDATA[recruitment@xing.com]]></contact_email> <poster_url><![CDATA[https://www.xing.com/profile/Max_Muster]]></poster_url> <user_role>EXTERNAL_RECRUITER</user_role> <banner_image_url><![CDATA[http://companyname.com/jobs/job1/banner.jpg]]></banner_image_url> <tags> <tag><![CDATA[Sales]]></tag> <tag><![CDATA[Management]]></tag> </tags> <skills> <skill><![CDATA[Communication]]></skill> </skills> <salary> <range_start>50000</range_start> <range_end>70000</range_end> <currency>EUR</currency> </salary> <posting_url><![CDATA[http://companyname.com/jobs/job1/iframe-compatible-view]]></posting_url> <industry_id>90000</industry_id> <video_url><![CDATA[https://www.youtube.com/watch?v=0TCQKSAbLCI]]></video_url> <order_id>123456</order_id> <student_classification><![CDATA[INTERNSHIP]]></student_classification> <job_type><![CDATA[FULL_TIME]]></job_type> <reply_setting><![CDATA[email]]></reply_setting> <billing_reference><![CDATA[3001231]]></billing_reference> <career_level><![CDATA[JOBLEVEL_1]]></career_level> <xing_apply_configuration> <external_links> <external_link> <url>http://companyname.com/privacy</url> <type>PRIVACY_POLICY</type> </external_link> <external_link> <url>http://companyname.com/terms</url> <type>TERMS_AND_CONDITIONS</type> </external_link> </external_links> </xing_apply_configuration> </posting> <!-- end full example --> </postings> </feed>
<?xml version="1.0"?> <feed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://dev.xing.com/jobs/xsd"> <postings> <posting> <id>1</id> <job_title><![CDATA[Senior Sales Manager]]></job_title> <description_template> <title_color>#004665</title_color> <!-- begin description text in mutiple fields --> <company_description> <title><![CDATA[Über uns]]></title> <content><![CDATA[Lorem ipsum dolor sit]]></content> </company_description> <responsibility> <title><![CDATA[Deine Aufgaben]]></title> <content><![CDATA[Lorem ipsum dolor sit]]></content> </responsibility> <skills> <title><![CDATA[Dein Profil]]></title> <content><![CDATA[Lorem ipsum dolor sit]]></content> </skills> <!-- end description text in mutiple fields --> <!-- OR --> <!-- begin description text in one single field --> <generic_description> <![CDATA[ <h3>Company description</h3> <p>Lorem ipsum dolor sit consetetur sadipscing elitr, sed diam nonumy eirmod tempor.</p> <h3>Your responsibilities</h3> <ul> <li>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</li> <li>Sed diam nonumy eirmod tempor invidunt.</li> </ul> <h3>Your skills</h3> <ul> <li>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</li> <li>Sed diam nonumy eirmod tempor invidunt.</li> </ul> ]]> </generic_description> <!-- end description text in one single field --> <header_image>http://companyname.com/jobs/job1/header.jpg</header_image> <footer_image>http://companyname.com/jobs/job1/footer.jpg</footer_image> <video_youtube>https://www.youtube.com/embed/video-id</video_youtube> <social_youtube>https://www.youtube.com/channel/channel-id</social_youtube> <social_xing>https://www.xing.com/pages/example-company-name</social_xing> </description_template> <url><![CDATA[http://companyname.com/jobs/job1]]></url> <company_name><![CDATA[Companyname Inc.]]></company_name> <job_location> <city><![CDATA[Hamburg]]></city> <country><![CDATA[DE]]></country> </job_location> <contact_email><![CDATA[recruitment@xing.com]]></contact_email> <poster_url><![CDATA[https://www.xing.com/profile/Max_Muster]]></poster_url> <user_role>EXTERNAL_RECRUITER</user_role> <banner_image_url><![CDATA[http://companyname.com/jobs/job1/banner.jpg]]></banner_image_url> <tags> <tag><![CDATA[Sales]]></tag> <tag><![CDATA[Management]]></tag> </tags> <skills> <skill><![CDATA[Communication]]></skill> </skills> <salary> <range_start>50000</range_start> <range_end>70000</range_end> <currency>EUR</currency> </salary> <posting_url><![CDATA[http://companyname.com/jobs/job1/iframe-compatible-view]]></posting_url> <industry_id>90000</industry_id> <video_url><![CDATA[https://www.youtube.com/watch?v=0TCQKSAbLCI]]></video_url> <order_id>123456</order_id> <student_classification><![CDATA[INTERNSHIP]]></student_classification> <job_type><![CDATA[FULL_TIME]]></job_type> <reply_setting><![CDATA[email]]></reply_setting> <billing_reference><![CDATA[3001231]]></billing_reference> <career_level><![CDATA[JOBLEVEL_1]]></career_level> <xing_apply_configuration> <external_links> <external_link> <url>http://companyname.com/privacy</url> <type>PRIVACY_POLICY</type> </external_link> <external_link> <url>http://companyname.com/terms</url> <type>TERMS_AND_CONDITIONS</type> </external_link> </external_links> </xing_apply_configuration> </posting> </postings> </feed>
You need to provide several fields for each job posting in your feed. The following listing provides you with an overview. Unless stated otherwise, fields should be considered mandatory, i.e. they should not be empty.
Field | Description |
---|---|
id |
Unique identifier for your job ads.
Never use the same ID for two different ads. Length is limited to 100 characters. |
job_title |
The title of the job ad. The length needs to be between 3 and 255 characters. |
description |
The description of the posting.
Your posting should at least contain line break tags for a good user experience.
The following HTML tags are available for styling:
h1 , h2 , h3 , h4 , h5 , h6 , hr , a , br , li , ol , ul , p , em , i , b , strong
Other tags and attributes including style tags and inline CSS will be removed. Length is limited to 10.000 characters. You may only use either description or description_template. |
city | City of the job location. Please provide real and exact values only. For example, sending “Somecity (near Munich)” as city would be accepted by the API but may lead to problems with our geolocation search and, as a result, less traffic for your job posting on our search page. Multiple locations are not supported. |
description_template |
The description_template is a complex field with multiple child elements which allows for greater control over the appearance of your job ad.
The individual fields are described further below in this documentation.
The total length may not exceed 20.000 characters.
You may only use either description or description_template. |
url | Application link of the posting. This must link to a publicly accessible website. |
company_name | Name of the company advertising this job posting. Length is limited to 100 characters. |
job_location | Must contain 'city' and 'country'. It may also contain 'address', 'zip_code' or 'latitude' and 'longitude'. The country value should be one from the available values here . Only one location is supported per ad. |
Optional fields | |
remote_options optional |
Choose one, multiple, or no value from this list of optional fields to define the possible remote options for the job posting:
|
company_profile_url optional | An URL to the corresponding XING company profile / employer branding profile. If provided this overwrites the default profile which is defined per feed. The posting will link to and appear on this profile. |
publish_to_company_profile optional |
A boolean value indicating whether the posting will be shown on the XING company profile / employer branding
profile defined in the company_profile_url parameter.
|
billing_reference optional | A text field that can be used to identify your postings for billing reasons. It is not shown on the job posting. Length is limited to 100 characters. |
banner_image_url optional |
URL to the banner image for this ad. Only available for Basic+ and Standard ads. Accepted formats are:
"image/jpg" , "image/png" , "image/gif" , "image/jpeg" , "image/pjpeg" , "image/x-png"
The maximum image size is 936x200px. Your image will be centered horizontally if it's smaller than the maximum width and sized down keeping the image dimensions if it's bigger than the maximum image size. The maximum file size is 1 MB. |
contact_email optional | E-mail address of the point of contact. |
poster_url optional | The XING profile url of the point of contact. The corresponding profile will be shown beneath the job posting as point of contact person. |
user_role optional |
Requires poster_url. Specifies the role of the point of contact person. Must be one of:
|
reply_setting optional |
Defines how a user can apply to a job posting. Must be one of:
|
tags optional |
May contain several The maximum length of all tags combined, separated by comma, is 500 characters. (not visible to users) |
skills optional |
May contain several The maximum length of all skills combined, separated by comma, is 255 characters. (not visible to users) |
salary optional |
Must contain a
range_start
and
range_end
which specify the lower and upper bound of the yearly salary range as integer. It may include an optional
currency
tag. The default value is 'EUR'.
|
posting_url optional | Please note that this is only available for Professional / Professional+ ads. If you’d like to use full HTML, please use the posting_url parameter to include a HTTPS-URL to a job posting on your website which will then be shown in an iframe as a description of your job ad. Where possible, we recommend you also provide a text description as this can be shown as a snippet in the search results. HTML content is cached for a period for 24 hours. However, images and other assets are not cached, so please make sure the whole web page and assets are available all the time. You’ll enjoy the best experience by making your content responsive or optimizing it for a width of 936px. Remove navigation elements as a job seeker is not supposed to navigate in the iframe view of your job posting. Furthermore, don't use advanced scripts as we can not guarantee scripts to work correctly within embedded postings. Please also make sure you use UTF-8 encoding. You cannot use this together with a banner image. |
industry_id optional | Industry ID of the job posting. Please find available values here. |
video_url optional | URL pointing to a video on Vimeo or YouTube. The video will be displayed below the job posting content. This field is only available for Professional+ postings. |
order_id optional | Agencies and applicant tracking system providers posting for multiple customers with custom contracts need to define the order_id for each posting so that they can be billed correctly. |
student_classification optional |
If this is a job posting for Campus, please specify the type of work done by the student. Must be one of:
|
job_type optional |
Type of this job posting. Must be one of:
|
career_level optional | Career level of the job posting. Please find available values here. |
xing_apply_configuration optional |
External urls for privacy policies and, terms and conditions for a job posting.
It requires
external_links
and may contain at maximum one external_link per field type. The
external_link
must be composed by
url
and
type
Field type
must be one of:
external_links
cannot be changed after they are created
|
description_template.title_color optional | Color of headlines for all sections in the description_template. The format is a hex color code (e.g. #004665) |
description_template.company_description optional |
Describes what your company is doing and what an applicant should know about your company. If present, it must contain a "content" field and optionally a "title".
The following HTML tags may be used to style the content field:
h2 , h3 , h4 , h5 , h6 , hr , a , br , li , ol , ul , p , em , i , b , strong
|
description_template.responsibility optional |
What will be the responsibilities of an applicant in their new position. If present, it must contain a "content" field and optionally a "title".
The following HTML tags may be used to style the content field:
h2 , h3 , h4 , h5 , h6 , hr , a , br , li , ol , ul , p , em , i , b , strong
|
description_template.skills optional |
What skills do you desire or require from the applicant to be the right fit for this job. If present, it must contain a "content" field and optionally a "title".
The following HTML tags may be used to style the content field:
h2 , h3 , h4 , h5 , h6 , hr , a , br , li , ol , ul , p , em , i , b , strong
|
description_template.we_offer optional |
A description of special offers you have for your employees. If present, it must contain a "content" field and optionally a "title".
The following HTML tags may be used to style the content field:
h2 , h3 , h4 , h5 , h6 , hr , a , br , li , ol , ul , p , em , i , b , strong
|
description_template.contact_info optional |
A description of how to get in touch with you. If present, it must contain a "content" field and optionally a "title".
The following HTML tags may be used to style the content field:
h2 , h3 , h4 , h5 , h6 , hr , a , br , li , ol , ul , p , em , i , b , strong
|
description_template.generic_description optional |
Instead of using the description sections (e.g. company_description, responsibility, skills, we_offer, contact_info), you can define your own custom description with the generic_description.
It may contain the following HTML tags:
h2 , h3 , h4 , h5 , h6 , hr , a , br , li , ol , ul , p , em , i , b , strong
|
description_template.header_image optional | URL to an image that will be displayed on top of the job posting. This field accepts valid http or https URLs ending in .jpg, .jpeg and .png extensions (e.g. https://example.com/some-image.jpg). |
description_template.footer_image optional | URL to an image that will be displayed at the bottom of the job posting. This field accepts valid http or https URLs ending in .jpg, .jpeg and .png extensions (e.g. https://example.com/some-image.jpg). |
description_template.video_youtube optional | URL of an embedded YouTube video (e.g. https://www.youtube.com/embed/...). |
description_template.video_vimeo optional | URL of a Vimeo video (e.g. https://player.vimeo.com/video/...). |
description_template.social_website optional | URL of your company's website. Between 0-1000 characters (e.g. https://www.you-social-website.com/...). |
description_template.social_facebook optional | URL of your company's Facebook page. Between 0-1000 characters (e.g. https://www.facebook.com/...). |
description_template.social_twitter optional | URL of your company's Twitter page. Between 0-1000 characters (e.g. https://twitter.com/...). |
description_template.social_youtube optional | URL of your company's YouTube channel. Between 0-1000 characters (e.g. https://www.youtube.com/...). |
description_template.social_xing optional | URL of your company's Xing page. Between 0-1000 characters (e.g. https://www.xing.com/...). |
description_template.social_instagram optional | URL of your company's Instagram account. Between 0-1000 characters (e.g. https://www.instagram.com/...). |
description_template.social_pinterest optional | URL of your company's Pinterest page. Between 0-1000 characters (e.g. https://www.pinterest.com/...). |
description_template.social_tiktok optional | URL of your company's Tiktok account. Between 0-1000 characters (e.g. https://www.tiktok.com/...). |
description_template.social_kununu optional | URL of your company's Kununu account. Between 0-1000 characters (e.g. https://www.kununu.com/...). |
This image will give you an idea of how your postings will look in XING Jobs. Hover over the image to see relations to the field names.
About the employer branding section:
This section will appear automatically for Basic+ postings as we link your job postings to your Company Profile or Employer Branding Profile.
Therefore, please let your XING contact person know in whose profile your job postings should be listed. You may overwrite this per posting by providing the 'company_profile_url' parameter.
The following list shows you how certain HTML tags will look in XING Jobs:
<h1>Heading H1</h1> <h2>Heading H2</h2> <h3>Heading H3</h3> <h4>Heading H4</h4> <h5>Heading H5</h5> <h6>Heading H6</h6> <hr> <p>This is a paragraph text<br> Here was a break</p> <ul> <li>Unordered list UL list element LI 1</li> <li>Unordered list UL list element LI 2</li> </ul> <ol> <li>Ordered list OL list element LI 1</li> <li>Ordered list OL list element LI 2</li> </ol> <em>EM tag</em> <strong>Strong Tag</strong>