The XING E-Recruiting API allows to post job postings on XING Jobs as well as monitoring their status and performance. This guide is designed to help you get up and running quickly with the XING E-Recruiting API by outlining the most important steps.
First things first: Only XING customers with a valid contract are able to post job ads on XING via API. If you don’t have an organization-id and an order-id from a contract yet, please e-mail firstname.lastname@example.org
The XING E-Recruiting API allows you to post Standard, Professional, Professional+ and Campus postings. Some products may have different available and mandatory fields than other products do. The following table is intended to give you an overview of these technical characteristics:
The XING E-Recruiting API uses OAuth 2.0 for authenticating with the API server. Further details about that are available here:
Examples on how to implement the OAuth handshake with the XING APIs using different programming languages can be found here. Most of these examples use a third-party OAuth library, meaning that you generally don’t need to implement the OAuth handshake on your own.
To create postings on XING Jobs you'll need a valid contract providing you order_id and organization_id. We provide test IDs that enable you to use the XING E-Recruiting API to test your integration independently of a valid contract. These IDs will create your postings in the public accessible XING Jobs. Please do not create and activate postings unnecessary. Test postings will be archived after five clicks automatically. Use the following test IDs until your application is production ready:
|Product||Order ID||Oranization ID|
As soon as you post a job posting, it will be available in your XING Job Manager, but not yet active. After activating the posting, it will be visible to everyone on XING Jobs. You can switch your posting between the active and deactivated state during the whole term. When the posting expires it will be archived. An archived posting can not be reactivated. Please see the following state diagram for a complete overview:
These calls allow you to create, update, delete, activate, deactivate and archive postings, and to get status information about your posting or orders.
|Create a new posting||POST||/vendor/jobs/postings|
|Update an existing posting||PUT||/vendor/jobs/postings/:id|
|Activate a posting||PUT||/vendor/jobs/postings/:id/activate|
|Deactivate a posting||PUT||/vendor/jobs/postings/:id/deactivate|
|Archive a posting||PUT||/vendor/jobs/postings/:id/archive|
|Delete a posting||DELETE||/vendor/jobs/postings/:id|
|Get a list of postings||GET||/vendor/jobs/postings|
|Get a list of postings performance||GET||/vendor/jobs/postings/performance|
|Get a list of postings states||GET||/vendor/jobs/postings/status|
|Get a list of orders information||GET||/vendor/jobs/orders|