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.

Getting started

First things first: Only XING customers with a valid contract for Basic or Basic+ postings are able to post job postings on XING via a feed. If you don’t have a contract yet, please e-mail e-recruiting@xing.com or call +49 40 419131 955.

To integrate your job postings via feed, please make sure your feed meets the following basic requirements:

Protocol and format:
You need to provide an HTTP(S) or FTP URL for your job feed. This web resource must be available permanently.
Accepted formats is XML.
Encoding and compression:
HTTP content encoding must be UTF-8. HTTP compression gzip is supported.
Authentication:
HTTP basic authentication, common FTP authentication as well as POST/GET parameters for authentication are supported.
Don't use IP filters for authentication as our server IPs may change over time.

How it works

The following will give you an overview of how data is collected and integration takes place:

Data delivery
Your feed will be fetched three times a day. Currently there is no way of pushing feeds into the XING Jobs.
Posting status and expiration
Job postings will stay online in XING Jobs as long as they’re in your feed. As soon as you remove a posting from your feed, the next fetch cycle will remove it from XING Jobs, too. However, there are a couple of other situations where your job posting may be removed:
  • If your feed is unavailable for technical reasons, job postings will stay online for seven days since the last time they were successfully loaded
  • Your postings will be deactivated when your contract expires
Identification and updates
Your postings are being tracked using their unique ID / reference number.
Existing postings will be updated if changes are detected.
Design and HTML support
Please see below for information about designing HTML postings.
There is no support for templates.
Banner image
Basic+ orders support banners. There are two ways you can use banner images in your job ads:
  • Submit a single image to our support which then will be used for all current and subsequent postings in the feed
  • Define a unique image per ad, as described below

Feed structure and downloads

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.



Example feed
<?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>false</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>
            <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>
              <amount>70000</amount>
              <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>
          </posting>
          <!-- end full example -->
        </postings>
      </feed>

Detailed information for fields

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.
job_title The title of the job.
description A full description of your job posting which may contain the following HTML tags:
h1, h2, h3, h4, h5, h6, hr, a, br, li, ol, ul, p, em, i, b, strong, a
Text-only is not supported. Your postings should at least contain line break tags for a good user experience. There is no support for stylesheets, scripts or tag attributes. Please see Jobs integration for more information about posting design.
url Application link of the posting. This must link to a publicly accessible website.
company_name Name of the organisation with a vacancy to fill.
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
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 ad will be shown on the XING company profile / employer branding profile defined in the company_profile_url parameter. Default is true.
banner_image_url optional URL to the banner image for this ad. Only available for Basic+ 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 centred 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.
reply_setting optional Defines how a user can apply to a job posting. Must be one of:
  • url (default)
  • email - requires contact_email
  • private_message - requires poster_url
tags optional May contain a comma-separated list of tags to help find your ad.
(not visible to users)
skills optional May contain a comma-separated list of skills to be used to match candidates.
(not visible to users)
salary optional Must contain a fixed yearly amount . 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 an banner image.
industry_id 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:
  • THESIS
  • INTERNSHIP
  • PARTTIME
job_type optional Type of this job posting. Must be one of:
  • FULL_TIME
  • PART_TIME
  • CONTRACTOR
  • INTERN
  • SEASONAL
  • TEMPORARY
  • VOLUNTARY

Jobs integration

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.

Job market integration
Job market integration

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.

HTML styles

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><br>
<strong>Strong Tag</strong>
<a href="https://xing.com">This is a link</a>
Job market styling

Do's and don'ts

Do

  • Provide the full content of your job ads
  • Make use of header and list HTML tags to create structured ads
  • Use CDATA for complex content <![CDATA[...Content...]]>
  • Provide a banner. Your postings will look nicer and get more attention
  • Provide a salary. Your posting will appeal to more job seekers

Don't

  • Change your feed structure
  • Use plain text descriptions without any HTML
  • Provide wrong or misspelled company names

Frequently asked questions

Why is my posting not listed in XING Jobs (yet)?
Make sure the posting is in your feed and provides all of the mandatory fields. It may take up to 24 hours for a new posting to appear in XING Jobs.
Could you change the title / content / style for a certain ad?
The posting content and all other fields will appear in XING Jobs in exactly the same way they are provided in the feed. XING does not modify any content or text structure.
Can I provide multiple feeds / sources?
Yes, you can. However, do bear in mind that two feeds with different structures may lead to double the integration fee.
Do I have to follow the XING documentation?
Please follow this documentation to import job postings into XING Jobs.