XML Job Feed

Before getting started, review our partnerships page here.

The Indeed XML feed lists job information that will be displayed on Indeed. By maintaining an XML feed, you have greater control over how jobs are displayed. You can also choose to add the Indeed Apply label to jobs or sponsor jobs for a set budget and time.

Using the XML feed

Create and maintain an XML document containing all job information. Indeed monitors the file for changes in one of three ways:

  • By crawling an XML URL
  • By crawling an FTP site
  • By receiving the file directly in an Indeed FTP server (zipped files required)

Include all clients and all jobs hosted on each client’s career page in your XML feed. Indeed does not accept incomplete XML feeds and does not support partial opt-in of jobs/clients.

XML feed example

The following example shows a basic XML feed containing one job.

XML feed elements

The XML feed contains basic elements, used once per feed, and a set of job elements that are used for each job in the feed.

Basic elements

Element Required Description Example value
<source> Yes The root node for the XML feed document.
<publisher> No The name of the ATS from which this job was published. ATS Name
<publisherurl> No The URL for the ATS from which this job was published. http://www.atssite.com/
<job> Yes Contains all metadata specific to a job. Include one <job> element for each job to be displayed on Indeed. See following section for details.

Job elements

Note: All job content must be wrapped in <![CDATA[]]> nodes.

Element Required Description Example value
<title> Yes The title of the job. Do not include other types of information such as employment type, job location, job descriptions, copies, or headlines. <![CDATA[Sales Executive]]>
<date> Yes The date on which this job was first published. <![CDATA[Fri, 19 Dec 2014 22:49:39 GMT]]>
<referencenumber> Yes A unique identifying number for this job. Indeed uses this element to identify each job. Do not change the number once you’ve set it. <![CDATA[unique123131]]>
<url> Yes The URL for this job listing on your site. Use the URL for the job description page, not the application page. Include the source=Indeed token to track clicks from Indeed. <![CDATA[http://www.examplesite.com/
viewjob.cfm?jobid=unique123131&source=Indeed]]>
<company> Yes The company name to be displayed in search results. This can either match sourcename or be the name of an individual unit or brand.
You can use different company names under the same sourcename for different jobs as long as they are consistent. For example, if the client is a franchise owner or operates multiple branded locations under the same company, company should be the business unit or brand name in the simplest possible form that job seekers quickly understand.
<![CDATA[[ABC Hospital]]>
<sourcename> Yes The ATS client name. This element must be consistent for each unique client. This name is linked to campaigns and other settings. Use the simplest form of the company name without any additional information such as location. Do not change the name once you configure it. <![CDATA[ABC Medical Group]]>
<city> Yes The city in which this job is located. <![CDATA[Phoenix]]>
<state> Yes The state in which this job is located. Use the appropriate postal abbreviation. If your job is located outside the US, use the corresponding geographic designation such as province or region. <![CDATA[AZ]]>
<country> Yes The country in which this job is located. <![CDATA[US]]>
<postalcode> No The postal code in which this job is located. <![CDATA[85003]]>
<streetaddress> No The street address of the job’s primary work location. Please include the street name and number. If possible, provide the full address including city, state, and postal code. <![CDATA[1234 Sunny Lane
Austin, TX 78750]]>
<email> Yes The email account associated with the Indeed account for this client.
Indeed’s Search Quality team uses this email address to verify the legitimacy of the business entity posting the job.
<![CDATA[example@abccorp.com]]>
<description> Yes The description for this job listing. Ensure the information in the <description> matches the details on the <url> page.
Note: Job descriptions require HTML formatting. For a list of supported HTML elements, see Formatting Guidelines.
<![CDATA[
Do you have 1-3 years of sales
experience? [...] ]]>
<salary> No The salary offered for this job. <![CDATA[$50K per year]]>
<education> No The desired education level for this job. <![CDATA[Bachelors]]>
<jobtype> No The type (full- or part-time) of this job. <![CDATA[fulltime, parttime]]>
<category> No A comma-delimited list of job categories, used to aid job seekers when searching. <![CDATA[Category1, Category2, CategoryN]]>
<experience> No The desired experience for this job. <![CDATA[5+ years]]>
<tracking_url> No You can provide a unique URL for each job in order to track clicks on Indeed. Indeed creates a GET request to this URL each time the job is clicked. <![CDATA[https://www.examplesite.com/
trackjob1234]]>
<metadata> Yes A comma-delimited list of supplemental job metadata provided by the client, used to aid Indeed customer service reps with campaign management. <![CDATA[Metadata1, Metadata2, MetadataN]]>

Formatting guidelines

Indeed expects you will use the same HTML formatting from your website when you provide job descriptions in XML. Include your formatting in CDATA tags.

Note: We do not support escaped HTML entities. For example, use < instead of &lt;.

Supported tags include but are not limited to the following examples:

Tag Description
<b> Bold
<h1> to <h6> Headers
Note: Text in header tags transform to consistent sizes when displayed on Indeed pages.
<br> Line break
Note: Indeed automatically inserts line breaks between paragraphs.
<p> Paragraph
<ul> Unordered list (bullets)
<li> List item
<strong> Strong text (bold)
<em> Emphasized text (italics)
<table>, <tbody>, <th>, <tr>, <td> Simple tables

Additionally, we support computed style nodes like the following:

  • <font style="font-weight:bold">Some bold text</font> will result in bold text.
  • <div><h2 style="display:inline">Label: </h2> Text</div> will display “Label: Text” in-line, despite the fact that <h2> is a block element by default.
  • A paragraph tag must have positive top/bottom margin/padding. This is the <p> tag’s default behavior.

Formatting example

How it looks on Indeed

 

Job Description:

  • Do you have 1-3 years of sales experience?
  • Are you relentless at closing the deal?
  • Are you ready for an exciting and high-speed career in sales? If so, we want to hear from you!

Benefits

We provide competitive compensation, including stock options and a full benefit plan. As a fast-growing business, we offer excellent opportunities for exciting and challenging work. As our company continues to grow, you can expect unlimited career advancement!

Common issues

The following problems can cause Indeed to reject your XML feed.

Issue Solution
Incorrect special character encoding Check the feed URL using the “view source” function in your browser and ensure special characters such as brackets (< >) show up correctly.
Jobs missing from the feed or job counts differing between the feed and career sites Include every job in the feed. Anything published and available on the web should be in the feed. Remember that Indeed is a search engine and indexes the more comprehensive source.
Incomplete or empty job descriptions Include all text related to the job. For example, “required qualifications” may be a separate category in your database, but for Indeed’s purposes, it should be included in the <description> field.
Jobs that are scams or suspected scams Indeed works to exclude suspected scams. Ensure that positions have well-written descriptions. If submitting jobs for another company, vet the company to ensure that it is legitimate and the listed jobs are actual open positions.
Old jobs in the file Indeed only indexes jobs from the last 120 days.

XML Feed FAQ

What are the options for delivering the feed?

Indeed monitors the file for changes in one of three ways:

  • By crawling an XML URL
  • By crawling an FTP site
  • By receiving the file directly in an Indeed FTP server (zipped files required)

How often does Indeed index the XML feed?

Indeed refreshes each XML feed 4 times per day. Jobs are available on Indeed within an hour after the feed is indexed.

What metadata can be included?

You can include any fields you like (ex. <job_type>, <branch_id> ) as long as the standard fields are present.

Will every job in the feed appear in Indeed search results?

Visibility in search results is based on Indeed’s visibility rules. Our Search Quality team prioritizes jobs that are legitimate, unique, have detailed descriptions and locations, and are easy to apply to. Jobs that do not meet these criteria may be hidden from search results.

If I’m using Indeed Apply and allowing job seekers to apply directly from Indeed, why must I provide a URL?

We require a URL that points to the job description (not apply page), for 2 reasons:

  • If Indeed Apply fails, we direct the job seeker back to the job URL.
  • The job seeker can click to see the original job from Indeed at any time.

What happens if I have the same job in multiple languages?

Provide the job in every language you currently have it as a unique job in the XML. If you duplicate the reference number in the XML, only the first appearance of the job appears on Indeed.

What happens if I have the same job in multiple countries?

Provide the job in every location where there is an open position. Region-wide postings that are not region-wide jobs are rejected for organic visibility on Indeed.

What happens if I have a statewide/country-wide job?

Indeed requires city, state/province, country, and postal code elements. If these elements are not provided, the job does not receive organic visibility.

If you have legitimate region-wide postings or remote work opportunities, include them in the file and have your clients request organic visibility. If your client has an Indeed account, they can log in to get support. Clients without an account can submit questions to Indeed directly by visiting our website.

Why do you require an email for each job?

For companies that are new to Indeed, or for new job sources from companies already on Indeed, we require a contact email address to verify the account and enable organic syndication. In some cases the email address is not used, but we require it for all jobs.

Next steps

Consider these options:

  • Before submitting your XML feed to Indeed, refer to the XML Checklist.
  • You can use the Indeed Apply API to allow job seekers to apply without leaving Indeed. To learn more, see Adding Indeed Apply (IA).
  • Learn how ATS clients can sponsor jobs on Indeed through an Applicant Tracking System (ATS) using the Sponsored Jobs ATS Integration.
  • Explore other topics in Indeed Apply documentation on our home page.