Linkedin XML Feed
The LinkedIn XML feed contains the information required to ingest and post jobs on LinkedIn. To expedite your implementation process, as well as ensure the accuracy of your ingested jobs’ details, create the XML feed in the below format:
Creating the XML Feed
The XML feed contains two types of job elements:
Mandatory
Recommended
Mandatory Fields
Following is the list of fields that must be included on the Limited Listings XML feed for the jobs to be considered as valid to be posted on LinkedIn:
Job ID
Company Name
Job Title
Job Description
Location String
Apply URL
LinkedIn Company ID [Mandatory for Applicant Tracking Systems (ATSs)]
Job Posting Field Schema
This following table lists and describes the job fields supported by the Limited Listings XML feed:
Note
Fields that are not mandatory are recommended.
JOB POSTING FIELD SCHEMA
Field Name
Field
Description
Mandatory
Value Type
Last Build Date
lastBuildDate
Most recent feed generation timestamp
No
String
Publisher URL
publisherURL
Your public web presence
No
String
Publisher
publisher
Your company name
No
String
Expected Job Count
expectedJobCount
Expected job count for the next feed scrape
No
Integer
Partner Job ID
partnerJobId
The unique ID used by the partner to reference the job within their own system
Yes
String (max. 40 chars)
Company Name
company
Company name of the client (name of the employer)
Yes
String
Job Title
title
Title of the job. This field cannot be changed once the job is posted
Yes
String
Job Description
description
Yes
String (min. 100 chars)
Apply URL
applyUrl
URL to which candidates are directed to apply (typically the URL of the job on the client's website or ATS system)
Yes
URL starting with "https://www"
Company ID
companyId
Client's company ID on Linkedin. This can be found in the Admin URL for the LinkedIn Page
Yes (for ATSs)
Location
location
This is a description of the job location. US locations - City, State (for example, “San Francisco, CA”) Non-US locations - City, Country (for example, “London, United Kingdom”) LinkedIn automatically maps this to a country and postal code unless those fields are provided. Separate jobs need to be created for different cities/locations
Yes
String
City
city
City of the job location (for example, “San Francisco”)
Yes, only if location is not provided
String
State
state
State of the job location (for example, “California”)
Yes, only if location is not provided
String
Country
country
Country of the job location (for example, “US”)
Yes, only if location is not provided
Postal Code
postalCode
Postal code of the job location
No
String
Is Remote Job
isRemote
Whether a job is hiring remote applicants or not. Location (city and country) is a mandatory field for Remote jobs. Available options are: Yes, No
No
String
Industry Codes
industryCodes
List of industry codes for the company
No
List of industryCode elements
Industry Codes> Industry Code
industryCodes/ industryCode
Represents industries of this job or company. Industry IDs are predefined by LinkedIn and can be retrieved from Industry Codes reference table
No
Experience Level
experienceLevel
Experience level of the job position to hire. Available options are: ENTRY_LEVEL, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, INTERNSHIP, ASSOCIATE, NOT_APPLICABLE
No
String
Job Functions
jobFunctions
List of job functions for this job
No
List of jobFunction elements
Job Functions> Job Function
jobFunctions/ jobFunction
Represents job functions specific to this job (for example, Accounting, Marketing, Sales). Category names are predefined by LinkedIn and can be retrieved from Job Functions Codes reference table
No
Job Type
jobtype
Employment status of the job position. Available options are: FULL_TIME PART_TIME, CONTRACT, INTERNSHIP, VOLUNTEER
No
String
Salaries
salaries
Provided salary for this job posting. Each <salary> object under the <salaries> list should represent a component of the total salary for the job
No
List of salary elements
Salaries > Salary > High End/Low End > Amount
salaries/salary/ highEnd(lowEnd) /amount
The value for the higher/lower end of the range of the salary for this job posting
No
Integer
Salaries > Salary > High End/Low End > Currency Code
salaries/salary/ highEnd(lowEnd) /currencyCode
The currency for the higher/lower end of the range of the salary for this job posting
No
Salaries > Salary > Period
salaries/ salary/period
The time period that this salary component is given at. Available options are: YEARLY, MONTHLY, SEMIMONTHLY, BIWEEKLY, WEEKLY, DAILY, HOURLY, ONCE
No
String
Salaries > Salary > Type
salaries/ salary/type
The type of this salary component. Available options are: BASE_SALARY, TOTAL_ADDITIONAL
No
String
List Date
listDate
The day the job was first posted on LinkedIn
No
String
Expiration Date
expirationDate
Date at which the job is expected to close
No
String
Formatting Guidelines
The following HTML tags are supported for description field. Other HTML tags will be stripped out, and their contents will be displayed as plain text.
FORMATTING GUIDELINES
Tag
Description
<b>, <strong>
Bold/Strong
<u>
Underline
<i>
italic
<br>
Line Break
<p>
Paragraph
<ul>
Unordered List
<li>
Ordered List
XML Feed Considerations
LinkedIn recommends the following feed considerations:
Ensure all required fields are populated correctly
Ensure Partner Job Id has a maximum length of 40 characters to be considered as valid
Ensure job descriptions have a minimum of 100 characters to be considered as valid
Minimize the number of expired jobs in your XML feed
Minimize the number of duplicate jobs in your XML feed
Do not use your company name or other job boards’ company name in place of the name of the company that originally posted the job
Include maximum information about the location such as full name of cities and countries. Providing only a city name can be ambiguous
Requirement Considerations
LinkedIn recommends the following requirement considerations:
Do not have duplicate jobs in feeds
Do not close and reopen jobs repeatedly
Do not use redirecting URLs for jobs
LinkedIn only accepts jobs that are directly posted by employers on your platform. Once the member clicks the 'Apply' button for these jobs on LinkedIn, they should be directly taken to the site where they can complete the application process. Ensure to exclude jobs from the feed that are aggregated from other third-party sites
A feed can contain maximum 500K jobs. However, for feeds with 500k jobs or more (large partners):
Split jobs into several feeds based on country location
Do not rotate jobs between feeds. Each feed should contain unique and consistent jobs to avoid having a job show on one feed today and later (or also) on another feed. Refer the below example of job rotation that may lead to errors at our end:
TABLE 3
Day
Source
Job ID
1
partition1
123
1
partition2
456
2
partition1
No Job ID with 123
2
partition2
123
Example XML Feed
Spider Name: Jobs_xmlHTMLCopy
Referenced Links
Last updated
Was this helpful?