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.

Basic XML feed example

<?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-apiToken=1234ABCDE&indeed-apply-jobTitle=Professional+Basket+Weaver+%28apply+by+email%29&indeed-apply-jobId=Sample+ID&indeed-apply-jobCompanyName=My+Favorite+Company&indeed-apply-jobLocation=Austin+TX&indeed-apply-jobUrl=http%3A%2F%2Fwww.indeed.com&indeed-apply-postUrl=https%3A%2F%2Fhookb.in%2FPxOjJqJELNH8lZLZDkpz&indeed-apply-questions=https%3A%2F%2Fpastebin.com%2Fraw%2F0vXq9q9b%23]]>
        </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.

HTML button example

<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.

List of parameters

Setting up your IA integration

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

Setting up your IA integration table

Topic	Description
Application data delivery	Choose whether to receive applications from job seekers through email or posturl. If you choose posturl, learn more about the JSON that must be read and parsed.
Encryption and decryption	If using Indeed Apply through email, you must encrypt the email to which Indeed sends applications.
Testing and monitoring your IA integration	Use the Indeed Apply test tool to test your configuration, review the integration checklist before submitting your XML feed, and learn how to monitor your integration to avoid common issues.
Disposition data integration	Set up a disposition data integration to provide updates about applications status.

Indeed Apply options

Consider the following options for your configuration:

Indeed Apply options table

Topic	Description
Including screener questions	Learn about adding screener questions to the Indeed apply application process.
Sponsored Jobs ATS Integration	If you are developing an applicant tracking system (ATS), you can allow clients to sponsor jobs on a pay-per-click basis. Read this topic to learn more about sponsoring jobs in your XML feed.

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.