XML Feeds - Developer FAQ

Jobs with complete and detailed information are more likely to be ingested, discovered and are better able to attract high quality applicants.

Partners should provide a static URL where LinkedIn can download the feed on an ongoing basis. Alternatively, partners can upload an XML feed to their own SFTP server.

The XML feed testing is conducted internally and we do not have an externalized environment for the same. We provide our partners with feedback on the performance of the feed or on technical changes. Further, if required by the partner, we can send screenshots of how the jobs would appear on LinkedIn from our internal testing environment. Upon partner approval we will push the feed live so that the jobs start posting on the LinkedIn company Page of their customers.

Partners must provide a full list of jobs. We recommend to update the feed every 12 hours to ensure freshness of jobs.

No. LinkedIn does not charge for ingestion and hosting of Basic Jobs.

No. However, you can provide information for all the recommended fields and increase the chances that a listing is posted.

We ensure that any duplicate jobs are removed from the feed. We prioritize our jobs based on their sources and accordingly deduplicate them to ensure the jobs on LinkedIn are from high quality sources.

There are several reasons why a Basic Jobs may not be posted on LinkedIn, such as:

1. LinkedIn Premium Job Post: Job is already posted as a paid job by the customer on their company page
2. Missing or Invalid fields: Jobs will not post if any mandatory field(s) is blank or have invalid info. Please refer to the XML requirements
3. Missing Company ID: Company ID is a mandatory field on the XML feed for ATSs. Please find the steps for retrieving Company ID
4. Employer opt-out: Employer has opted out of job ingestion from any third-party site
5. Spam Jobs: Jobs posted on LinkedIn may be selected to undergo our jobs review process and must meet our guidelines as part of our commitment to professionalism and integrity. If jobs do not meet the guidelines, they may be marked as spam
6. Claimed Jobs: Claim a job is a new functionality that allows a LinkedIn member working with the company hiring for the job to convert it to a free job post which they can manage through LinkedIn. The member can choose if they want to continue collecting applications on the ATS or on LinkedIn.

If after checking the above details, your Basic Jobs still does not post, please follow the process to file a ticket with our Help Center for further information.

There are several reasons why a Basic Jobs may not be posted on LinkedIn. You can follow the below to ensure jobs are posted:

• Ensure all mandatory fields are populated correctly
• Ensure that the job descriptions are 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’s name or other job boards’ company names in place of the name of the employer hiring for the job
• Include as much location information as possible. The city name by itself may be ambiguous so ensure to include State and Country/Region (where ever available)

The jobs must be associated with the actual employer hiring for the job.

Unfortunately, we cannot select a subset of open roles to ingest as Basic Jobs. We suggest you only send jobs on the feed that you would like LinkedIn to ingest.

Basic Jobs differ in the following ways:

• Job Slots have greater visibility across LinkedIn, being promoted in job searches and getting distributed across the platform via targeted recommendations in the LinkedIn feed, Jobs tab, and Notifications
• Basic Jobs are ingested jobs that only appear in the Jobs tab of the employers’ company Page and central Jobs search tab. Basic Jobs don’t offer access to premium features like the Job Analytics Report

For more information, refer to this Help Centre article

We scrape the XML feeds of ATS partners every six hours and for job board partners every 24 hours.

Yes, it is possible to make changes to a job already posted on LinkedIn. This can be done by making changes to the job on the XML feed. The job will be updated on LinkedIn by the next scrape, typically within 24 hours.

Starting January 4, 2022, we will support the following two ways to mark jobs as remote, on-site or hybrid:

• workplaceTypes field in the XML feed. Please see Job Posting Schema and workplace requirements here
• Include one of the following relevant hashtags in the job description:

Please note that only the above hashtags will be accepted. The hashtags will take precedence over the workplaceTypes field in marking the workplace nature of the job.

You can claim a Basic Jobs or ingested job if you work for the company hiring for the job. Once claimed, you can edit and manage it through LinkedIn as a free job or promote it for greater visibility.

Industry codes represent the LinkedIn code representative of industry. This is a mandatory value for any job to go live on LinkedIn. LinkedIn uses Company ID values provided in the XML feed or those inferred by our job-to-company standardizer (if Company ID is not available on the XML feed) to infer industry codes from the company page. For example, all jobs mapped to “BMW Group” company page will read industry as “Automotive”.
Since the Company ID field is mandatory for ATS partners, we have not made industry codes a "mandatory" field. In the event, you cannot provide the company ID, we will highly recommend you include the Industry field in the XML to ensure industry is available for jobs to go live.
Please contact LL-BD@linkedin.com in case you add or remove any fields in the XML feed.

Job Wrapping is a service provided through LinkedIn Recruiter which allows customers to prioritize which open jobs are automatically posted from your Applicant Tracking System (ATS) or career site into LinkedIn job slots.

For LinkedIn customers that have Job Slots, Job Wrapping is an efficient method to automate the job posting process of posting jobs into slots. To get started with job wrapping, LinkedIn customers should contact their LinkedIn account manager. More information on Job Wrapping is available here.

A standalone individual XML feed is recommended for mutual customers with job wrapping. This gives them greater control over how their jobs are “wrapped” or ingested from your ATS or career site and onto the LinkedIn platform. Customers can choose which fields from your system you want to include or do not want to include to determine how your jobs are listed on LinkedIn. To set-up such feeds, please have the customer contact their LinkedIn Account Manager. The consolidated XML feed will work well for non-LinkedIn customers or LinkedIn customers who do not use job wrapping. For more information on job wrapping, please click here

The XML Jobs feed is self-service so you maintain control over how your jobs are displayed on LinkedIn. This is a good option if:

1. The jobs on your career site are inconsistent or incomplete
2. You would like to use values from fields that are captured in your ATS but not displayed on your career site in order to influence how jobs are listed on LinkedIn
3. The job wrapping from your career site yields inconsistent results as your site updates at the same time we ingest jobs

1. Create a ticket using the following link: https://www.linkedin.com/help/recruiter.
   Note: If you are placing a request on behalf of a customer, ensure that you have a screenshot of the customer’s consent included as an attachment on the ticket.
   1. If you have a LinkedIn Recruiter seat, the "Recruiter Help Center" page displays. Get started under “Chat with support” or “Create a support ticket” on the right hand rail (as shown in the image below). We highly recommend the chat option (if available) for a faster turnaround.
   2. For all other members, the "How can we help" page displays (as shown in the image below). Proceed by selecting "Other" and type "Jobs" as a response to the question "What do you need help with?" You will see the option to "Create a support ticket" at the bottom of the page.
2. Fill out the ticket as per the below request scenario:
   1. Start ingestion from ATS feed as the preferred source of ingestion and opt-out other ingestion sources
      1. Contact Reason: General Question/Service Request
      2. Issue Type: Jobs
      3. Your Question: Please opt-in the following employer for Basic Jobs ingestion from the below ATS XML feed that is already integrated with LinkedIn. Please use the following information:
         1. ATS XML Name (JAM Source): ‘Your platform name’ ATS XML
         2. Employer Name: Exact company name as on the feed
         3. Company Page URL: LinkedIn Company Page URL starting with https://www.linkedin.com/company/
         4. We have also attached the consent from the customer for your reference. Please note that to stop ingestion from other sources on a given company Page, we need consent (screenshot) from either a company page admin, or someone that has a seat on a connected Recruiter Dashboard to the company page that is either a Recruiter or Dashboard manager.
   2. Incorrectly mapped jobs
      1. Contact Reason: Something is broken or not working
      2. Issue Type: Jobs
      3. Your Question: Our customer’s job posting is incorrectly mapped to a different company, and needs to be edited. Please use the following information:
         1. Sample LinkedIn Job URL: LinkedIn Job URL starting with https://www.linkedin.com/jobs/
         2. Incorrect LinkedIn Company Page URL: LinkedIn Company Page URL starting with https://www.linkedin.com/company/
         3. Correct LinkedIn Company Page URL: LinkedIn Company Page URL starting with https://www.linkedin.com/company/