XML Feeds - Developer FAQ

Note

These FAQs are based on common developer questions.

Developer Questions

- Integration Phase FAQ

  1. Why should I provide recommended fields?
  2. How should we provide the feed?
  3. Is the XML feed testing conducted in an externalized environment?
  4. Should partners provide a full list of jobs or just the changes such as new jobs or edits to their list of jobs?
  5. Do I need to pay to have my jobs ingested?
  6. Does LinkedIn guarantee that it will ingest all listings from my feed?

- Product Functionality FAQ

  1. What if LinkedIn already has a subset of the jobs in my feeds?
  2. What are the possible reasons for a Basic Jobs not going live on LinkedIn?
  3. How can we ensure Basic Jobs from the feed are posted on LinkedIn?
  4. Will the jobs be associated with the Basic Jobs feed partner or the job posting company?
  5. Is it possible to only ingest a portion of listings from my feed?
  6. How are Basic Jobs different from LinkedIn Job Slots and LinkedIn Job Posts?
  7. How often is the XML feed scraped?
  8. Is it possible to make changes to a job after it has been posted on LinkedIn through the XML feed?
  9. How do I mark a job with workplace type as remote, on-site or hybrid?
  10. How can I edit or claim an ingested job?
  11. What are industry codes and why are they important?

- Customer Facing FAQ

  1. What is job wrapping?
  2. How is a standalone individual XML feed per customer different from a consolidated XML feed?
  3. When should customers use standalone XML Jobs Feed?

- Technical Support FAQ

  1. What is the support process to solve for technical issues with the feed or job postings?

Product FAQs

Integration Phase

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

How should we provide the feed?

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.

Is the XML feed testing conducted in an externalized environment?

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.

Should partners provide a full list of jobs or just the changes such as new jobs or edits to their list of jobs?

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

Do I need to pay to have my jobs ingested?

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

Does LinkedIn guarantee that it will ingest all listings from my feed?

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

Product Functionality

What if LinkedIn already has a subset of the jobs in my feeds?

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.

What are the possible reasons for a Basic Jobs not going live on LinkedIn?

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. In some cases, we may require certain types of jobs to be promoted on LinkedIn. Jobs that require promotion may include jobs by companies with generic names (such as “Confidential Company”) or jobs from search and staffing companies. These limits are designed to prevent abuse, improve product quality, and increase transparency while ensuring that job seekers have access to the best possible opportunities. Please note that LinkedIn reserves the right to require promotion of jobs.

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.

How can we ensure Basic Jobs from the feed are posted on LinkedIn?

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)

Will the jobs be associated with the Basic Jobs feed partner or the job posting company?

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

Is it possible to only ingest a portion of listings from my feed?

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.

How are Basic Jobs different from LinkedIn Job Slots and LinkedIn Job Posts?

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

How often is the XML feed scraped?

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

Is it possible to make changes to a job after it has been posted on LinkedIn through the XML feed?

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.

How do I mark a job with workplace type as remote, on-site or hybrid?

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:

Workplace Type Hashtag
On-Site #Li-onsite
Hybrid #Li-hybrid
Remote #Li-remote

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.

How can I edit or claim an ingested 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.

What are industry codes and why are they important?

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.

Customer Facing

What is job wrapping?

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.

How is a standalone individual XML feed per customer different from a consolidated XML feed?

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

When should customers use standalone XML Jobs Feed?

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

Technical Support

What is the support process to solve for technical issues with the feed or job postings?

  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. Signed-in View
    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. Signed-in View
  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/