Sponsored Jobs API usage policy

Indeed enforces a Sponsored Jobs API usage policy. Effective February 1, 2026 in EU markets, GB, CH, CA, AU, NZ, ID, IN, BR, PH, CL, SG, CO, TH, CR, MY, MX, and PA; effective December 1, 2024 in the US.

 

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.

• January 08, 2026:

  • Effective February 1, 2026, Indeed enforces a usage policy for the Indeed Sponsored Jobs API for all users in EU countries and Switzerland. The list of EU markets where Indeed has advertisers includes: AT, BE, CH, DE, DK, EE, ES, FI, FR, GR, IE, IT, LU, NL, PL, PT, RO, SE.

    Calls to the Sponsored Jobs API are charged 3 EUR or the equivalent in the advertiser’s selected billing currency per call. Charges incur only when monthly campaign sponsorship spend is less than the total monthly API call cost.

  • Effective February 1, 2026, Indeed enforces a usage policy for the Indeed Sponsored Jobs API for all users in AR, AU, CA, GB, ID, IN, BR, NZ, PH, CL, SG, CO, TH, CR, MY, MX, PA.

    Calls to the Sponsored Jobs API are charged 3 USD or the equivalent in the advertiser’s selected billing currency per call. Charges incur only when monthly campaign sponsorship spend is less than the total monthly API call cost.

    This policy requires Indeed Sponsored Jobs API customers to pay for API usage based on their sponsorship spend. This policy does not apply to those who use Indeed's proprietary ATS plugin.

    For recommended API usage patterns, see Sponsored Jobs API best practices to reduce call volume.

    Use of the Sponsored jobs API is limited to paying customers that sponsor their jobs through a campaign within the last three calendar months.

    Sponsored Jobs API usage is subject to a maximum number of API calls allowable in a given calendar month. The maximum number of Sponsored Jobs API calls for any month corresponds to the greater of the previous month’s Sponsored Jobs campaign spend OR credit limit.

    Call the /apiquotausage endpoint to retrieve data on your current month’s API usage.

• January 08, 2026:

  • Effective December 1, 2024, Indeed enforces a usage policy for the Indeed Sponsored Jobs API in the United States.

    This policy requires Indeed Sponsored Jobs API customers to pay for API usage based on their sponsorship spend.

    This policy does not apply to those who use Indeed's proprietary ATS plugin.

    For recommended API usage patterns, see Sponsored Jobs API best practices to reduce call volume.

• June 17, 2024:

  • Effective June 30, 2024, Indeed decommissioned the GET /v1/stats/datastatus endpoint.

  • Requests to this endpoint return the HTTP 404 status code. Use GET /v1/stats instead.

• June 15, 2024:

  • Effective June 26, 2024, Indeed decommissioned the GET /v1/campaigns/:campaignId/stats/:date and GET /v1/campaigns/:campaignId/stats/entryDates endpoints.

  • Requests to these endpoints return the HTTP 404 status code.

  • Use GET /v1/campaigns/{campaignId}/stats instead.

• June 3, 2024:

  • Effective June 26, 2024, Indeed limited the perPage parameter value to 500 for the GET /v1/campaigns endpoint.

  • The API rejects requests to this endpoint with a perPage parameter value that is greater than 500 as not valid.

Indeed’s Sponsored Jobs API usage policy

Indeed enforces a Sponsored Jobs API usage policy. Effective February 1, 2026 in EU markets, GB, CH, CA, AU, NZ, ID, IN, BR, PH, CL, SG, CO, TH, CR, MY, MX, and PA; effective December 1, 2024 in the US.

This usage policy enhances job fulfillment and creates a more equitable marketplace. The policy modernizes the API infrastructure to align with industry best practices and helps to prevent misuse and ensure fair access.

This usage policy protects the Indeed infrastructure from an automated process that uses the API in an inappropriate way. Excessive requests from an API might result from a harmless typo, or might result from an inefficiently designed system that makes needless API calls. Regardless of the cause, blocking traffic from a specific source once it reaches a certain level is necessary for the overall health of the Indeed job advertising system. It ensures that one advertiser's actions cannot negatively impact the larger community.

This policy requires Indeed Sponsored Jobs API users in the US, as Indeed determines, to pay for API usage based on job sponsorship spend. API usage is rate-limited based on customer spend. The API is available to paying customers only.

At the end of every billing cycle, customers pay the greater value, which is either:

• The monthly Sponsored Jobs API campaign spend, or
• Total monthly API call cost

Further, Indeed implements an API call limit to prevent accidental misuse or large, unplanned charges. Indeed enforces the API call limit on a calendar-month basis, and limits the maximum number of API calls on an advertiser ID basis.

The first $50 or equivalent in the advertiser’s selected billing currency of monthly API call costs is waived.

API call limit

Payment method	To calculate the API call limit
Credit card	Indeed takes the prior month’s Sponsored Jobs spend OR credit limit, whichever method provides the higher number of API calls, and divides this amount by $3 per call.
One of these methods: Prepay invoice Postpay invoice Postpay insertion order (IO)	Indeed takes the prior month’s Sponsored Jobs spend OR credit limit OR IO balance at the beginning of the month, whichever method provides the higher number of API calls, and divides this amount by $3 per call.

Indeed charges all APIs, even free-of-charge APIs, if you call them in employer scope.

See Free-of-charge API calls.

Scenario example

In this scenario:

• $450 was spent last month on Sponsored Jobs.
• The current credit limit is $400.

Because the Sponsored Jobs spend ($450) last month exceeds the current credit limit ($400), Sponsored Jobs spend is used to calculate the maximum number of API calls allowed in the current month.

Sponsored Jobs API scenario example

Item	Charge
Last month’s Sponsored Jobs spend	$450
Advertiser ID credit limit	$400
This month’s API call limit	[Maximum($450,$400)]/[$3 per call] = 150 calls

While this policy is a global policy, the rollout is staggered across geographies.

Usage policy details

Effective February 1 for all users in EU markets, GB, CH, CA, AU, NZ, ID, IN, BR, NZ, PH,CL, SG, CO, TH, CR, MY, MX and PA;, and effective December 1, 2024 in the United States, Indeed enforces a usage policy for all customers for the Sponsored Jobs API:

Paid access

Effective February 1, 2026 for all users in EU markets, GB, CH, CA, AU, NZ, ID, IN, BR, NZ, PH,CL, SG, CO, TH, CR, MY, MX and PA; and effective December 1, 2024 in the United States, access to the Sponsored Jobs API is limited to customers that have spent to sponsor jobs through a campaign within the last three consecutive calendar months.

Effective February 1, 2026 for all users in EU markets and Switzerland. The minimum expected spend on jobs sponsored through monthly campaigns from customers is €3 (EURO) for each API call made to the Sponsored Jobs API.

Effective February 1, 2026 for all users in GB, CH, CA, AU, NZ, ID, IN, BR, NZ, PH,CL, SG, CO, TH, CR, MY, MX and PA; and effective December 1, 2024 in the United States, the minimum expected spend on jobs sponsored through monthly campaigns from customers is $3 (USD) for each API call made to the Sponsored Jobs API.

Monthly billing

To calculate the bill for API calls at the end of each month, these values are compared:

Monthly billing

Value	Description
The total API call cost	Total API call cost = Number of API calls * $3 per API call
The monthly spend on jobs sponsored through monthly and lifetime campaigns

If value 1 is less than value 2, the customer is not charged an additional amount for the API calls.

If value 1 exceeds value 2, the customer is charged the difference.

The customer is the billing entity on record that accesses the API.

note

The first $50 or the equivalent in the selected billing currency of API call costs is waived. This value is automatically removed prior to invoice generation. No additional action is needed to receive the $50 fee waiver.

Examples

Scenario 1 example

In this scenario, 150 API calls are made in the month.

Because the total API call cost is less than the Sponsored Jobs monthly and lifetime campaigns spend, the customer is not charged an additional amount for the API calls.

Scenario 1 example

Item	Charge
Sponsored Jobs monthly and lifetime campaigns spend	$500
Total API call cost (150 calls * $3 = $450)	$450
Monthly bill for API calls	$450 - $50 fee waiver = $400

Scenario 2 example

In this scenario, 200 API calls are made in the month.

Because the total API call cost exceeds the Sponsored Jobs monthly and lifetime campaigns spend, the customer is charged the difference between those values.

Scenario 2 example

Item	Charge
Sponsored Jobs monthly and lifetime campaigns spend	$200
Total API call cost ( 200 calls * $3 = $600)	$600
Monthly bill for API calls	$600 - $50 fee waver = $550

The Detailed billing report shows the monthly bill for API calls is $600, as follows:

• Sponsored Jobs monthly and lifetime campaigns spend: $200
• Total API call cost: $350

API usage recommendations

To reduce the number of calls made to the API, see Sponsored Jobs API best practices to reduce call volume.

For free-of-charge API calls, see Free-of-charge API calls.

For information about data retrieval, see Data retrieval.

Free-of-charge API calls

These Sponsored Jobs API calls are free of charge:

Free-of-charge API calls

API call	See
API calls made through ATS JavaScript Plugin.	ATS JavaScript Plugin
API calls that return an error. That is, the call returns an HTTP 3XX, 4XX, or 5XX status code.	Status codes
API calls to get an OAuth access token, regardless of scope.	Get an access token
Get advertiser's API quota usage. Free of charge when you call this operation with an access token that represents an employer.	Get advertiser's API quota usage

note

To reiterate, these Sponsored Jobs API calls are always charged:

• API calls made in employer scope, except API calls to get an OAuth access token or API calls that return an error.
• Successful calls. That is, the call returns an HTTP 2XX status code.

Status codes

The charge for Sponsored Jobs API calls depends on the HTTP status codes that the API call returns:

Status codes

HTTP status code	Charged?
200	Yes
201	Yes
202	Yes
302	No
400	No
401	No
403	No
404	No
405	No
406	No
415	No
429	No
500	No
503	No

 

Was this page helpful?