Adding Indeed Apply

Use the Indeed Apply (IA) API to mark your jobs with the Easily Apply label and allow job seekers to apply without leaving Indeed.

The Indeed Apply API takes approximately two to three weeks to implement from start to deployment.

Indeed Apply can be implemented in one of two ways:

• If you maintain an Indeed XML feed, you must add an Indeed Apply element to your feed. See Adding IA using the XML feed for instructions.
• If you do not maintain an Indeed XML feed, you can add the Indeed Apply HTML button to the job description pages on your website. See Adding IA using the HTML button for instructions.

Generating an API token

Before implementing the Indeed Apply API, generate an API token by logging in to your Indeed Advertiser account or creating a new account.

Adding IA using the XML feed

If you maintain an Indeed XML feed, add Indeed Apply configuration attributes to an <indeed-apply-data> element in your existing feed.

Indeed Apply configuration attributes are outlined in the IA Configuration parameters table.

IA XML element example

The following example shows a basic XML feed containing one job and the Indeed Apply element.

Note: The basic job elements are omitted for clarity, but must be present in your feed.

<?xml version="1.0" encoding="utf-8"?>
<source>
    <publisher/>     
    <publisherurl/>
    <lastBuildDate/>
    <job>
        <title/>
        <date/> 
        <referencenumber/>
        <url/>
        <company/>
        <sourcename/>
        <city/>
        <state/>
        <country/>
        <email/>
        <postalcode/>
        <description/>
        <salary/>
        <education/>
        <jobtype/>
        <category/>
        <experience/>
        <indeed-apply-data>
            <![CDATA[indeed-apply-joburl=http%3A%2F%2FJill-Gaba.SFAgentJobs.com%2Fj%2F0b0yx&indeed-apply-jobid=514473&indeed-apply-jobtitle=Account%20Associate%20-%20State%20Farm%20Agent%20Team%20Member&indeed-apply-jobcompanyname=Jill%20Gaba%20%20-%20State%20Farm%20Agent&indeed-apply-joblocation=Macedonia%2C%20OH%2044056&indeed-apply-apitoken=1234ABCD&indeed-apply-posturl=http%3A%2F%2Fapp.careerplug.com%2Fjobs%2F1928%2Fapps.json&indeed-apply-phone=required&indeed-apply-questions=http%3A%2F%2Fapp.careerplug.com%2Fjobs%2F1928%2Fquestions.json]]>
        </indeed-apply-data>
    </job>
</source>

IA XML element restrictions

The following restrictions apply when configuring Indeed Apply using the XML feed:

• Attributes must be URL encoded.
• If a field is included in the XML feed, it must not be blank.
• Data attributes must include the prefix indeed-apply-. Do not use data-indeed-apply- as a prefix.
• All standard configuration attributes can be passed using the XML feed with the following exceptions. These attributes only work when using the HTML button:
  • onapplied
  • onclick
  • continueUrl

Adding IA using the HTML button

If you do not maintain an Indeed XML feed, you can implement Indeed Apply by adding an HTML button to job description pages on your site. Add Indeed Apply configuration attributes to a span element with the class indeed-apply-widget and include JavaScript to enable it.

The Indeed Apply button is not optimized for single-page applications (SPAs) or a webpage that hosts a button that loads the bootstrap.js script multiple times without reloading the entire page.

Note: If you maintain an XML feed, please use the XML element instructions to enable Indeed Apply for your jobs on Indeed. Using this HTML method will only apply to jobs on your site.

Indeed Apply configuration attributes are outlined in the IA Configuration parameters table.

IA HTML button example

The following example shows the markup required for the Indeed Apply HTML button, including the JavaScript to enable the feature.

<span class="indeed-apply-widget"
    data-indeed-apply-apitoken="INSERT YOUR APITOKEN HERE"
    data-indeed-apply-jobid="7775e2bc62b7f77e"
    data-indeed-apply-joblocation="New York, NY 10110"
    data-indeed-apply-jobcompanyName="Your Company"
    data-indeed-apply-jobtitle="Test Engineer"
    data-indeed-apply-joburl="http://www.yourcompany.com/careers/yourjob123.html"
    data-indeed-apply-posturl="http://www.yourcompany.com/process-applications"
    data-indeed-apply-jobmeta="right-rail-apply-button"></span>

<script>(function(d, s, id) {
var js, iajs = d.getElementsByTagName(s)[0];
if (d.getElementById(id)){return;}
js = d.createElement(s); js.id = id;js.async = true;
js.src = "https://apply.indeed.com/indeedapply/static/scripts/app/bootstrap.js";
iajs.parentNode.insertBefore(js, iajs);
}(document, 'script', 'indeed-apply-js'));
</script>

IA configuration parameters

Whether using the XML feed or the HTML button, set up the Indeed Apply API using the following configuration parameters.

Note: You can add all of these parameters to the Indeed Apply button as HTML5 data attributes. You must include the prefix data-indeed-apply- to the data attributes.

Setting up your IA integration

To complete your integration, review the following topics and follow the instructions appropriate for your configuration.

Indeed Apply options

Consider the following options for your configuration:

Next steps

• Maintain an XML feed to have better control over how jobs are displayed. To learn more, see XML Job Feed.
• Before submitting your XML feed to Indeed, refer to the Integration Checklist.
• Be sure to complete your integration as described in Setting up your IA integration and consider the Indeed Apply options.
• Provide updates about application statuses by setting up a Disposition Data integration.
• Explore other topics in Indeed Apply documentation on our home page.