Sponsored Jobs API integration guide for ATS partners

Access private endpoints, including campaign predictions and organic job performance and prediction.

 

legal notice

Unless you have a written agreement with Indeed regarding your use of Indeed's APIs, by using this API or its documentation, you agree to apply the Indeed API Terms and the Additional API Terms and Guidelines to your use of Indeed's APIs.

Overview

Read this guide alongside the Sponsored Jobs API reference for ATS partners. It helps ATS partners integrate with the Sponsored Jobs API (the API) but does not document every endpoint.

In this guide and the public API docs, employer and advertiser both refer to the user who sponsors jobs at Indeed. Send technical questions to marketplacesupport@indeed.com.

Program overview

Set up your ATS with the program.

When you design the prototype, plan the user experience flow first.

User experience flow

Build two flows in your ATS: one for creating an employer account, and another for creating and managing ad campaigns.

New employer account setup flow

Each employer who wants to use Indeed needs one Indeed account and a primary account admin who authorizes your ATS to act on the employer's behalf. Complete this step once per employer. An employer can have multiple ATS users but only one Indeed account for sponsorship campaigns. Employers can't create campaigns until they finish this setup.

1. The employer’s account admin enters the corporate email address used to sign in to Indeed.
2. Your ATS prompts them to complete setup on Indeed.
3. When their Indeed account is set up, redirect their account admin to authorize your ATS system through Indeed OAuth.
4. After they authorize your ATS, enable the admin to configure which of their ATS user accounts can create sponsorship campaigns using their Indeed account. This depends on the user’s role inside the ATS.

For implementation details, see Set up employer account.

Campaign creation and management flow

Surface the Indeed advertising experience where it fits best in your platform — for example, the marketplace, job performance reviews, or an analytics page.

Use our API endpoints to let authorized ATS users create and manage Indeed sponsored job campaigns directly in your ATS.

Users can:

1. Set a budget and duration for each job campaign.
2. Set hiring objectives per job and receive recommendations from Indeed.
3. Accept Indeed's Terms of Service.
4. Contact Indeed when needed.

Manage campaign

Let authorized ATS users:

1. View basic Indeed analytics in your ATS, including:

   • Cost, applies, clicks, and impressions
   • Links to the Indeed dashboard for more details

2. End ATS-created campaigns or add budget to them.

For integration details, see Sponsored Jobs API overview.

Set up your ATS with the program

Follow these setup steps to start using the Sponsored Jobs API as an ATS partner. Email marketplacesupport@indeed.com with any questions as you build.

Set up your ATS with the program

Step	Description
1.	Sign a Developer Agreement with Indeed.
2.	Create an Indeed account with your ATS email address.
3.	Identify the redirect URL within your ATS where Indeed sends your users.
4.	Start your integration.
5.	Send a demo video to Indeed.
6.	Work with Indeed on messaging.

Sign a Developer Agreement with Indeed

Verify that your company has a Developer Agreement with Indeed that covers the Sponsored Jobs Integration APIs and Referral Partnership terms.

If you don't, email marketplacesupport@indeed.com to request one.

Create an Indeed account and register your integration

Create an Indeed account with your ATS company email address. Use this account only for OAuth authorizations and to register your ATS integration. From now on, use this email and account to manage your clients' employer accounts at Indeed.

Also email marketplacesupport@indeed.com to request a unique ATS identifier, which you need to set up employer accounts.

When you become an Indeed partner, Indeed sets up an app for your integration. Sign in to Partner Console to view your app and OAuth credentials (client ID, secret, and authorization code for 3-legged OAuth). Exchange credentials for an access token to authenticate API calls.

Identify the redirect URL where Indeed sends users

Choose the ATS redirect URL Indeed uses to send users to your ATS after they set up their employer account.

Start your integration

You're ready to start your integration. See the API integration overview.

To test it, create a separate Indeed account to act as a client account. Use a different email than the one you used to create your Indeed account.

• Test the various UX features with this account using $50 budgets.
• Indeed covers up to $200 in sponsored job clicks on your company's real jobs so you can verify the integration works. This refund is a one-time offer for this single account.
• Reply to Indeed's email with the address you use for testing so Indeed can confirm success.

As you build your integration, follow the brand and logo guidelines.

Email a demo video to Indeed

Email a demo of your integration to marketplacesupport@indeed.com.

Subject: New ATS-SJI API Approval Request

Body:

ATS Name:

Product Contact:

BD/Marketing Contact:

Redirect URL (from Step 4):

UX Video:

Indeed replies within 48 hours to approve or request changes.

Work with Indeed on messaging

Work with Indeed on messaging to help your clients get started, and be ready to announce the new features to them. Email marketplacesupport@indeed.com with any open questions.

API integration overview

Before you call the Sponsored Jobs API for an employer, verify the employer has an Indeed account and has granted your system OAuth authorization to call the API on their behalf.

Complete the prerequisites to handle these steps.

Integration prerequisites

Before you start calling the Sponsored Jobs API, complete these steps:

1. Set up employer account.
2. Get OAuth authorization from each employer.

Set up employer account

Complete these steps for each new employer to verify they have an account set up for sponsoring at Indeed.

Step 1

Show a dialog (or similar) that asks an admin user with the right access and information to set up sponsoring at Indeed and finish onboarding. The dialog prompts the user for a corporate email address.

Step 2

Send the user to the Indeed account setup endpoint. This endpoint runs account readiness checks and prompts the user through any required setup steps.

The endpoint is:

https://ats-management.indeed.com/accountsetup

Make an HTTP GET request to this endpoint with these parameters:

Set up employer account

Field	Required	Description
__email	✓	URL-encoded email address to use for sponsoring at Indeed.
ak	✓	Unique ID Indeed assigns to each ATS partner. Identifies the employer accounts the partner refers to Indeed.
state		String returned to the ATS unchanged. Use it as a key to identify the request. Must be 1–100 alphanumeric characters.
type		One of: login Stops after Indeed account creation and skips the rest of the sponsoring setup. Use this to meet the minimum requirements for the Organic job performance and prediction endpoint. For details, see Set up no sponsorship. Omit the parameter Runs the employer through the full setup flow.

You can reuse the Indeed account setup endpoint to redirect the admin user and confirm the employer is set up for sponsorship on Indeed. The process is lightweight — if all checks pass, the call returns immediately with no further user interaction.

The endpoint runs these account readiness checks:

• The Indeed account with the given corporate email address is set up to use Indeed.
• The user is signed in to Indeed.
• The employer account is set up for sponsoring.
• The billing information is set up for sponsoring.
• The user has full access to the employer account.

If any check fails, Indeed redirects the user to the right setup page and then re-runs the checks to confirm setup is complete.

For secondary users, at least one of the employer accounts they can access must pass the checks.

Step 3

After you complete setup steps, Indeed redirects the user to your ATS using the redirect URL you provide. You must create a redirect URL on the ATS side to which Indeed redirects users to after the Indeed onboarding process is complete.

Endpoint must support these parameters

Field	Description
state	The API echoes back whatever value you pass in this field.
result	Value is: OK At least one of the user's accessible employer accounts passed every check. INVALID_EMAIL_FORMAT The email address is malformed. INVALID_STATE_PARAMETER The state parameter is malformed. INVALID_TYPE_PARAMETER The type parameter value is invalid. Only login is accepted. EMAIL_CHANGE_REQUESTED The user wants to use a different corporate email as their primary Indeed account. BILLING_SETUP_CANCELED Either the user canceled billing setup, or they're a secondary user without any accounts that passed the checks.

Step 4. Ask the user to grant you OAuth authorization

On success, send the user to the OAuth authorization flow.

New employer setup workflow

Use this flow both to set up sponsoring at Indeed and to update billing information whenever needed.

If a user's billing information is no longer valid, send them through the account management flow to fix it.

Set up no sponsorship

If an employer hasn't set up an Indeed account yet but wants to view Indeed's performance data before sponsoring any jobs, add the optional type=login parameter to the request URL. This parameter triggers Indeed account creation for the employer and skips the remaining checks.

Use type=login to access the organic job performance and prediction endpoint when the employer hasn't sponsored any jobs yet. After the employer finishes setting up their Indeed account, redirect the user to the OAuth authorization endpoint.

Get OAuth authorization from each employer

This authorization is required for each new employer account, and associated secondary users. The Sponsored Jobs API uses the standard OAuth 2.0 Authorization code grant. In this flow, end users grant you access to their account and campaign data at Indeed. You call the API using the OAuth access token you obtain from the end user.

Follow the authorization code grant type (3-legged OAuth) to set up your Indeed account for OAuth and get authorization to call the API on behalf of your clients.

In the authorization code request, select the correct scope for the endpoint you are calling. See OAuth scopes for details.

In addition to these Sponsored Jobs Campaigns API scopes, get an access token that represents an employer. See Get access token that represents employer.

The access and refresh tokens you receive, which are unique for each employer account at Indeed, are required to make calls to the API. Ensure you store them securely. If these tokens are lost, your client must grant you OAuth access again.

Secondary users and OAuth authorization

The primary user is the admin user who sets up employer account. This user has full access to all resources associated with the employer account at Indeed. Primary users can provide access to other people on their employer account. These additional users are called secondary users. Primary users can add and view secondary users and their permissions by visiting their Indeed Account page.

Indeed recommends that you add each user who manages campaigns for an employer as a secondary user. Then, get OAuth authorization for each secondary user. See Get OAuth authorization from each employer.

To list of employer accounts the user can access, you can get user information.

For secondary users, the behavior of the Indeed account setup endpoint is:

• If the user has full access (admin permissions) to at least one employer account with valid billing information, the account setup endpoint returns them to your ATS with the OK result.
• If the user does not have full access to any employer account, or none of those employers have valid billing information, the endpoint shows an error page about not having suitable employer accounts. The page has a link that returns the user to your ATS with the BILLING_SETUP_CANCELED error.

After the user selects one of the employer accounts returned from the v2/api/userinfo endpoint, use the account management endpoint to verify that the account has valid billing information.

Sponsored Jobs API overview

These technical specifications supplement the Sponsored Jobs API reference for ATS partners. They describe the endpoints you can use for your integration. Some of the endpoints are private and exclusive to ATS partners. Others are public endpoints.

Base URL

ATS partners can access the API at this base URL.

apis.indeed.com/ads

Endpoints

Public endpoints

The following endpoints are detailed in our Sponsored Jobs API reference for ATS partners.

Wherever endpoints define two different ways to use the API, one as an ad agency and the other as the direct employer, use the direct employers method.

• Account management
• Campaign management
• Reports

Private endpoints

These endpoints are restricted to ATS partners who are set up for this program.

• Campaign predictions
• Organic job performance and prediction

OAuth scopes

In your OAuth authorization code request, pass the scopes that correspond to the API endpoints you are calling. Then, the end user chooses whether to grant you none, some, or all scopes that you requested. Use the following table to determine which scope to request for each API endpoint.

Campaign predictions

Campaign predictions scopes

API endpoint	OAuth scope	Access token type
POST /v1/campaignpredictions	employer_access	With employer_access scope. See Get access token that represents employer.

Organic job predictions

Organic job predictions scopes

API endpoint	OAuth scope	Access token type
POST /v1/organicjobpredictions	employer_access	Any

Handle authorization errors

Verify you handle any errors that occur when the user does not have access to the requested scopes or does not authorize your application. To determine which scopes have been granted, view the scope response field in the request an access token response.

The error codes are:

Authorization error codes

Error code	Description
403 INSUFFICIENT_SCOPE	The access token is valid but has not been granted the necessary scope.
401 INVALID_TOKEN	The access token is missing, invalid, or expired.

For suggestions on how to handle these errors, see Recommended best practices. You can offer the user the option to complete the OAuth Authorization code grant again to authorize your app with more scopes. However, some users might have restricted permissions and cannot authorize all the scopes you request.

If your app has not been granted all requested scopes, enable it to operate with a limited feature set.

Recommended best practices

The API follows an eventual consistency model. That is, when you create a campaign through the POST /v1/campaigns endpoint, you might not get the new campaign from the GET /v1/campaigns/{campaignId} endpoint for a brief time.

Ensure you have a retry mechanism in place if you try to get a resource immediately after creation or modification.

In addition, ensure that you continuously monitor for 4XX-level error responses from the API to determine whether there are API usage issues.

5XX-level error responses from the API are typically temporary internal service issues and could be retried after some delay. If you are unsure of how to resolve the issue or if the errors persist, because the request path was not prefixed with /ads, the response indicates that the request could not be routed to the Sponsored Jobs API.

For example, instead of https://apis.indeed.com/v1/account, use https://apis.indeed.com**/ads**/v1/account. reach out to marketplacesupport@indeed.com for help with diagnosis. You might encounter 401 INVALID_TOKEN and 403 INSUFFICIENT_SCOPE errors when using OAuth scopes.

Account management

GET	/v1/account	Sponsored Jobs API reference for ATS partners

Use this endpoint to get basic information about the employer.

The following responses indicate that the employer must complete the Set up employer account:

• If the endpoint returns 400 NOT_EMPLOYER_ACCOUNT, this indicates that the user does not have an Indeed employer account.

• To include the account billing status in the response, pass the following in the fields parameter: fields=id,email,contact,company,jobSourceList,billingActive.

  If the returned value of the billingActive field is false, the user has not completed the necessary account set up at Indeed to start sponsoring.

Campaign management

An employer's campaign corresponds to what an employer can manage in the Indeed Analytics dashboard. All job campaigns at Indeed have unique IDs, for example: 784e4acec9x100z2.

Use the following endpoints to:

• Create campaigns
• Update a campaign
• Get a campaign’s budget
• Update a campaign’s budget

Create campaigns

POST	/v1/campaigns	Sponsored Jobs API reference for ATS partners

Use this endpoint to create a campaign. This endpoint returns the ID of the new campaign. Store this campaign ID and use it to make changes to the campaign or to get reports about it.

When you create a campaign, set the budget and the duration that the employer chose.

The budget must be in the same currency as the default currency of the employer.

• The minimum budget and duration required are $50 and seven days.
• For each job, use its unique reference number that is set in the XML feed.
• All dates have the format YYYY-MM-DD and are specified in the US Central time zone.

To create a campaign, set these parameters

Field	Description
jobsToInclude	Always set to query.
jobsQuery	Use refnum:xxxxx and replace the xxxxx with the unique reference number defined for the job. This should match the value of the referencenumber node in the XML job feed. Specify in the refnum:xxxxx format. Example: refnum:12345
jobsSourceName	Source or company for this job. Must exactly match the sourcename node of the job in the XML job feed. Example: Robertson Recruiting

If the employer chooses a monthly campaign

Monthly recurring campaigns follow the calendar month.

Field	Description
budgetMonthlyLimit	The budget amount.
budgetFirstMonthBehavior	Set to startNowProratedAmount.

If the employer chooses a fixed duration campaign

Field	Description
budgetOnetimeLimit	Budget amount.
startDate	Campaign start date. Defaults to today. In the format YYYY-MM-DD and is specified in the US Central time zone.
targetEndDate or fixedEndDate	Set targetEndDate or fixedEndDate for the campaign in YYYY-MM-DD format and in the US Central time zone. targetEndDate Indeed efficiently optimizes budget spending by this date. However, if the campaign still has a budget remaining, the campaign continues to spend past this date. fixedEndDate A hard stop date for the campaign. Indeed efficiently optimizes budget spending by this date and also ensures that the campaign doesn’t spend beyond the specified date.

Update a campaign

PATCH	/v1/campaigns/{campaignId}	Sponsored Jobs API reference for ATS partners

Use this endpoint to make changes to the campaign status.

Employers can set campaigns to one of the following statuses:

Status	Description
ACTIVE	Active campaigns can start sponsoring jobs.
PAUSED	Paused campaigns do not sponsor jobs until the employer makes them active.
DELETED	These campaigns have been deleted by the employer.

The statuses are only for the campaign and are independent of an employer’s billing status or remaining budget.

The campaign status can be active, but you might need to perform these checks to verify their billing status or remaining budget:

Campaign status	Additional check	Description
Active	Use the account management endpoint to check their billing status and confirm billing is active.	If billing is not active, the campaign cannot start spending. Alert the user with the message: “You must first add billing details to your Indeed account to fund your campaigns." Then to complete the set up, redirect the user to set up employer account.
Active	Use the get a campaign's budget and campaign performance endpoints to determine the remaining budget for the campaign.	If the remaining budget is zero, the campaign cannot continue to sponsor the job. Ask the user whether to update the budget amount for the campaign. Use the update a campaign's budget endpoint to set the new total budget, which is the original amount plus any additional amount.

Get a campaign's budget

GET	/v1/campaigns/{campaignId}/budget	Sponsored Jobs API reference for ATS partners

Use this endpoint to get a campaign’s budget.

The fields returned vary depending upon whether the campaign has a single lifetime budget or is a monthly recurring campaign.

Monthly recurring campaigns

These campaigns follow the calendar month. The response includes the budgetMonthlyLimit field that contains the monthly budget amount.

Fixed time duration campaigns

Field	Description
budgetOnetimeLimit	Budget amount.
startDate	Campaign start date, in YYYY-MM-DD format, and in the US Central time zone. Defaults to today.
targetEndDate or fixedEndDate	Set targetEndDate or fixedEndDate for the campaign in YYYY-MM-DD format and in the US Central time zone. targetEndDate Indeed efficiently optimizes budget spending by this date. However, if the campaign still has a budget remaining, the campaign continues to spend past this date. fixedEndDate A hard stop date for the campaign. Indeed efficiently optimizes budget spending by this date and also ensures that the campaign doesn’t spend beyond the specified date.

Update a campaign's budget

PATCH	/v1/campaigns/{campaignId}/budget	Sponsored Jobs API reference for ATS partners

Use this endpoint to make changes to the campaign’s budget and duration.

Reports

Use the reporting endpoints to pull campaign performance reports from Indeed and make them available to employers.

Campaign performance

GET	/v1/campaigns/{campaignId}/stats	Sponsored Jobs API reference for ATS partners

Use this endpoint to get a campaign performance report for a given date range.

ATS Partners can use this report to present aggregated Clicks, Impressions, Conversions, and Cost information to employers.

The date range cannot exceed 366 days.

Parameter	Description
startDate	Report start date, inclusive, in YYYY-MM-DD format in the US Central time zone.
endDate	Report end date, exclusive, in YYYY-MM-DD format in the US Central time zone.
merge	Value is: true Aggregates all performance data for a date range. false The default. The response breaks down the data by date.

Get a campaign’s budget and combine the information with the campaign performance report to display the current budget for a job and the cost incurred to date.

To do this pass the campaign creation date in the startDate parameter of this endpoint.

Also pass, merge=true to aggregate the data.

This helps you find what was spent for a campaign from the campaign start date.

The campaign performance data that is returned includes:

• Impressions
• Clicks
• Conversions (Applies)
• Cost
• Currency Code (USD, GBP, and so on)

ATS Campaign predictions

POST	/v1/campaignpredictions	Private — Sponsored Jobs API reference for ATS partners

This endpoint:

• Estimates the expected job performance in terms of the number of total job applies for a budget.
• Recommends a budget to sponsor a job based on the desired performance.

For a specific job and its properties, these predictions are based on the past performance of similar jobs at Indeed. It can predict performance of campaign with multiple jobs as well

Predictions are currently available for US (English) jobs only and estimate performance for budgets lower than USD $100 per day. All budget amounts are specified in US dollars (USD).

Predictions are based on the job properties and the type and duration of the campaign.

After the employer accepts the recommended budget, create campaigns with the same parameters.

Parameter	Description
mode	Job mode value. Set to multi-job for predictions for campaigns with multiple jobs.

Request body

Field	Required	Description	Type
body	required	Job, campaign, and prediction information.	CampaignPredictions

CampaignPredictions

Field	Required	Description	Type
jobInfo	required	Describes a job and its properties.	JobInfo
campaignInfo	required	Describes the desired campaign type.	CampaignInfo
predictionsInfo	required	Specifies the desired number of applies or desired budgets for predictions.	PredictionsInfo

JobInfo

Field	Required	Description	Type
jobsLocation	required	City where the job is located. Example: Austin, TX	String
jobsQuery	required	Use refnum:xxxxx and replace the xxxxx with the unique reference number defined for the job. This should match the value of the referencenumber node in the XML job feed. Specify in the refnum:xxxxx format. Example: refnum:12345	String
jobsSourceName	required	Source or company for this job. Must exactly match the sourcename node of the job in the XML job feed. Example: Robertson Recruiting	String
jobsTitle	required	Job title. Example: Software Engineer	String

CampaignInfo

Field	Required	Description	Type
campaignType	required	Either ONETIME or MONTHLY Example: MONTHLY	String
startDate	conditional	Campaign start date, in YYYY-MM-DD format and in the US Central time zone. Defaults to today. Only applicable if campaignType is ONETIME. Example: 2021-08-01	String
endDate	conditional	Campaign end date, in YYYY-MM-DD format and in the US Central time zone. Required if campaignType is ONETIME. Example: 2021-08-10	String

PredictionsInfo

Field	Required	Description	Type
predictionType	required	Either BUDGET_BASED or APPLY_BASED Example: BUDGET_BASED	String
budgets	conditional	Budget for which to get an estimated performance. Performance is estimated in number of applies. Pass only one number in the array. Required if predictionType is BUDGET_BASED. Example: [75.50]	Double array
totalApplies	conditional	Desired number of total applies (organic and sponsored) across jobs for which you want a recommended budget. Pass only one number in the array. Required if predictionType is APPLY_BASED and appliesPerJob is not set. Example: [5]	Integer array
appliesPerJob	conditional	Desired number of applies (organic and sponsored) per job for which you want a recommended budget. Pass only one number in the array. Required if predictionType is APPLY_BASED and totalApplies is not set. Example: [5]	Integer array

Response

Name	Description	Type
currencyCode	Currency code for the budget amounts. Example: USD	String
predictions	The estimated performance or recommended budget overall for all the jobs.	Prediction array
jobLevelPredictions	Estimated performance or recommended budget for each jobs.	JobLevelPredictions array

JobLevelPredictions

Name	Description	Type
job	Job Details	Job Details
predictions	Estimated performance or recommended budget for a job.	Prediction array

Job details

Name	Description	Type
jobKey	Job key.	String
refNum	Job reference number.	String
title	Job title.	String
location	Job location.	String

Prediction

Name	Description	Type
budget	For BUDGET_BASED requests, this is the budget that the estimated number of applies is based on. For APPLY_BASED requests, this is the recommended budget to achieve the desired number of total applies.	Double
organicApplies	For BUDGET_BASED requests, the estimated number of organic applies for the job without sponsoring. Use totalApplies and organicApplies to calculate the estimated number of applies that result from sponsoring the job.	Integer
totalApplies	For BUDGET_BASED requests, the estimated number of total applies for an organic and sponsored job for a budget value. For APPLY_BASED requests, this is the number of total applies that the recommended budget is based on.	Integer
estimatedLowerApplies	For BUDGET_BASED requests, the estimated lower range of applies for an organic and sponsored job for a budget value. For APPLY_BASED requests, the response does not include this field.	Integer
estimatedHigherApplies	For BUDGET_BASED requests, the estimated higher range of applies for an organic and sponsored job for a budget value. For APPLY_BASED requests, the response does not include this field.	Integer

Example JSON request for prediction

{
  "jobInfo": {
    "jobsLocation": "Austin, TX",
    "jobsQuery": "refnum:12345",
    "jobsSourceName": "Bob’s Recruiting",
    "jobsTitle": "Software Engineer"
  },
  "campaignInfo": {
    "campaignType": "ONETIME",
    "startDate": "2021-08-10",
    "endDate": "2021-08-11"
  },
  "predictionsInfo": {
    "predictionType": "BUDGET_BASED",
    "budgets": [75.50]
  }
}

Example JSON response for prediction

{
  "currencyCode": "USD",
  "predictions": [{
    "predictionType": "BUDGET_BASED",
    "budget": 151,
    "organicApplies": 3,
    "totalApplies": 7,
    "estimatedLowerApplies": 3,
    "estimatedHigherApplies": 10
  }],
  "jobLevelPredictions": [{
      "job": {
        "jobKey": "80fdf7e9de72243f",
        "refNum": "12800649-92-99",
        "title\"": "Firmware Engineer",
        "location": "Irvine"
      },
      "predictions": [{
        "predictionType": "BUDGET_BASED",
        "budget\"": 75.5,
        "organicApplies": 2,
        "totalApplies": 4,
        "estimatedLowerApplies": 2,
        "estimatedHigherApplies": 5
      }]
    },
    {
      "job": {
        "jobKey": "79db86f75cbbde08",
        "refNum": "12800649-93-100",
        "title\"": "Principal Software Engineer",
        "location": "Irvine"
      },
      "predictions": [{
        "predictionType": "BUDGET_BASED",
        "budget": 75.5,
        "organicApplies": 1,
        "totalApplies": 3,
        "estimatedLowerApplies": 1,
        "estimatedHigherApplies": 5
      }]
    }
  ]
}

Organic job performance and prediction

POST	/v1/organicjobpredictions	Private — Sponsored Jobs API reference for ATS partners

This endpoint provides:

• The organic traffic statistics of a single job for the past 30 days
• The estimated organic traffic statistics for the next 30 days
• The estimated improvement in traffic if the job is sponsored

The performance is expressed in terms of clicks.

All budget amounts are specified in USD.

To use this endpoint, the employer’s admin user must have an account at Indeed by following the steps in Set up employer account. However, if you do not have billing information set up for sponsoring, you can pass the type=login parameter in the URL to simplify the setup flow.

Organic job performance and prediction request

Name	Required	Description	Type
body	required	Job-related information.	OrganicJobPrediction

OrganicjobPrediction field

Name	Required	Description	Type
jobInfo	required	Job description, and its properties.	JobInfo

JobInfo field

Name	Required	Description	Type
jobsQuery	required	The unique reference number that identifies the job, in "refnum:xxxxx” format. Should match the referencenumber node in the XML job feed. Example: refnum:12345	String
jobsSourceName	required	The source or company for this job, in "refnum:xxxxx” format. Should exactly match the sourcename node for the job in the XML job feed. Example: Robertson Recruiting	String

Organic job performance and prediction response

The response can differ depending on whether the job received traffic or whether sponsoring the job is recommended.

• If the job hasn’t received any traffic in the past 30 days, the value of the clicks field within the metric object is 0.
• If the job hasn’t existed for 30 days, traffic statistics are returned for the number of days the job existed (but the value of the days response field is still 30).
• If the recommendation is not available, the recommendation field is not returned.

Name	Required	Description	Type
metric	required	The organic traffic statistics of the given job for the past 30 days.	OrganicMetric
prediction	required	The estimated organic traffic statistics of the given job for the next 30 days.	OrganicPrediction
recommendation	optional	If available, the estimated sponsored performance of the given job with a recommended budget.	SponsoredPrediction

OrganicMetric field

Name	Description	Type
clicks	Number of clicks the job received in the last n number of days.	Integer
days	Number of days. Default is 30 days.	Integer

OrganicPrediction field

Name	Description	Type
clicks	For the next n number of days, the estimated clicks for the job.	Integer
days	Number of days. Default is 30 days.	Integer

SponsoredPrediction field

Name	Description	Type
clicks	For the next n number of days, the estimated clicks for the job.	Integer
days	Number of days. Default is 30 days.	Integer
budget	Recommended budget for sponsoring.	Double

Example JSON request

{
  "jobInfo": {
    "jobsQuery": "refnum:12345",
    "jobsSourceName": "Bob’s Recruiting"
  }
}

Example JSON response

{
  "metric": {
    "clicks": 30,
    "days": 30
  },
  "prediction": {
    "clicks": 40,
    "days": 30
  },
  "recommendation": {
    "budget": 250.0,
    "clicks": 70,
    "days": 30
  }
}

 

Was this page helpful?