ATS partner integrations for Sponsored Jobs API reference
View and manage an employer's sponsored jobs.
For Japan only: Add the 契約内容 link to your sponsorship confirmation page and tell ATS end users to download the Indeed job sponsorship contract as a PDF. The contract describes the PPC system, cancellation policy, fees, and more.
Additional migration note
This response field is deprecated and the API no longer returns it:
budgetOptimizationTargetfield returned fromGET /v1/campaigns/{campaignId}/budget
This response field is in the process of being deprecated:
AveragePagefield returned fromGET /v1/campaigns/{campaignId}/statsandGET /v1/campaigns/{campaignId}/stats/{date}
Client apps do not receive these fields. Make sure your app does not expect deprecated fields to be present in responses.
Authorization
ATS partners use the Authorization code grant type (3-legged OAuth) to act on behalf of client employers.
Make sure that:
The OAuth access token used to call the Sponsored Job API represents an employer. See Get access token that represents employer.
- If a user other than the employer's primary user is performing actions in the ATS, we recommended that the primary user adds these users as secondary users on Indeed. Each secondary user individually authorizes the ATS to act on their behalf on Indeed.
OAuth scopes
When requesting an OAuth access token, your app must request OAuth scopes, which determine the level of access the client grants your app. For details, see OAuth v2 token scopes. These scopes are also included in endpoint descriptions below.
Secondary users
The user that sets up an employer account at Indeed is called the primary user. The primary user has full access to all resources associated with the employer account at Indeed. Primary users can give others access to their Employer account. These additional users are called secondary users. Primary users can add and view secondary users and their permissions from their Account page.
Rate limiting
Indeed applies rate limiting to this API. This ensures system stability against unauthorized or unexpected use.
Eventual consistency
The API is expected to adopt an eventual consistency model. For example, when you call the POST /v1/campaigns campaign creation endpoint to create a campaign, a call to GET /v1/campaigns/{campaignId} might not return the new campaign for a brief time. See Prepare for eventual consistency in the Sponsored Jobs API get started.
Compatibility with API changes
Backwards-compatible changes to the Sponsored Jobs API can be released at any time and without prior notice. Changes considered backwards-compatible include:
- Add response fields.
- Reordering response fields.
- Changing descriptions of errors.
- Supporting new currencies and objective types.
To learn how to avoid issues caused by API changes, see Ensure compatibility with API changes.
Campaign dates
In the campaigns endpoint, dates are in US Central Time and should follow the ISO 8601 standard with a format of YYYY-MM-DD.
The campaign date fields are:
startDateUse the current date or a later date. If you do not provide a date, the default is the current date.
targetEndDate:A campaign can have only one end date:
targetEndDateorfixedEndDate.targetEndDatemust be at least one day after the start date. If set, Indeed optimizes spending by this date, but the campaign can continue spending after it if budget remains.fixedEndDate:A campaign can have only one end date:
targetEndDateorfixedEndDate.fixedEndDatemust be at least one day after the start date. If set, Indeed optimizes spending by this date and does not spend after it, even if budget remains.
Campaign traffic statistics
Campaign traffic statistics are available from January 1st, 2017.
Organic clicks and organic impressions
Starting on August 23rd, 2020, Indeed made organic clicks and organic impressions traffic statistics available. See the updated endpoints in the Reports and Detailed Reports sections. Organic metric data backdates to January 1st, 2017.
Search engine results page count
Starting on April 1st, 2020, Indeed changed the methodology for counting Search Engine Results Pages (SERP) impressions for some services. All impressions in the SERP are now counted when they are made visible to the user. This change speeds up the availability of certain performance metrics. The good news for you is that this helps:
- Deliver non-Sponsored jobs data much faster than before.
- Offer consistency on desktop and mobile reporting.
Conversion Tracker sunset
Indeed sunset Conversion Tracker effective October 1, 2021. As a result, Conversion Tracker data is not collected or displayed after October 1, and historical data is available until October 1, 2022. As a result, you may see lower conversions being reported effective October 1, 2021.
Objective-based campaigns
The Sponsored Jobs API supports objective-based campaigns. See Reach Your Recruiting Goals With Objective Based Campaigns. All campaigns created by Sponsored Jobs API are required to have an objective. If objectives are not provided by the employers at the time of new campaign creation, Sponsored Jobs API would select the appropriate objective for the campaign.
Note: Some objectives rely on the availability of app metrics. If you are not sure of the availability of app metrics, talk to your client success specialist to explore other solutions.
Endpoints
Endpoints that support objective-based campaigns are:
POST /v1/campaignsGET /v1/campaigns/{campaignId}PATCH /v1/campaigns/{campaignId}
Release dates
September 2, 2021
- Scheduled interviews – optimize for the number of interviews
December 7, 2021
- Target a specific cost per apply
- Maximize applicant volume
- Balanced objective – optimize equally for speed, quantity, and cost.
- Target a specific number of applies. For example, 10 applies for each job in the campaign.
- Target a specific number of interviews. For example, 10 scheduled interviews for each job in the campaign.
May 11, 2022
- All campaigns created by Sponsored Jobs API are required to have an objective. If objectives are not provided by the employers at the time of new campaign creation, Sponsored Jobs API would select the appropriate objective for the campaign.
August 26, 2022
- Sponsoring jobs on TMN is now supported by Sponsored Jobs API