Sponsored Jobs API usage policy
Effective 2024-12-01 in the US and 2026-02-01 in EU markets, GB, CH, CA, AU, NZ, ID, IN, BR, PH, CL, SG, CO, TH, CR, MY, MX, and PA.
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.
-
2026-01-08:
Sponsored Jobs API usage policy: as of 2026-02-01, per-call charges apply in these markets:
- EU markets and Switzerland (AT, BE, CH, DE, DK, EE, ES, FI, FR, GR, IE, IT, LU, NL, PL, PT, RO, SE): 3 EUR, or the equivalent in the advertiser's billing currency.
- Other markets (AR, AU, BR, CA, CL, CO, CR, GB, ID, IN, MX, MY, NZ, PA, PH, SG, TH): 3 USD, or the equivalent in the advertiser's billing currency.
Fees apply only when your monthly Sponsored Jobs campaign spend is less than your monthly API call cost.
The policy applies to all paying Sponsored Jobs API customers except users of Indeed's proprietary ATS plugin.
Eligibility: You can use the Sponsored Jobs API only if you sponsored a job in the last three calendar months.
Monthly call limit: The maximum is the greater of:
- Your previous month's Sponsored Jobs campaign spend.
- Your credit limit.
Monitor your usage: Call
/apiquotausageto retrieve your current month's API usage.For recommended API usage patterns, see Sponsored Jobs API best practices to reduce call volume.
-
2026-01-08:
Sponsored Jobs API usage policy (US): as of 2024-12-01, Sponsored Jobs API customers pay for API usage based on their sponsorship spend. The policy does not apply to users of Indeed's proprietary ATS plugin.
For recommended API usage patterns, see Sponsored Jobs API best practices to reduce call volume.
-
Effective 2024-06-30: the
GET /v1/stats/datastatusendpoint is decommissioned and returns HTTP404. UseGET /v1/statsinstead. -
Effective 2024-06-26: the
GET /v1/campaigns/:campaignId/stats/:dateandGET /v1/campaigns/:campaignId/stats/entryDatesendpoints are decommissioned and return HTTP404.Use
GET /v1/campaigns/{campaignId}/statsinstead. -
Effective 2024-06-26: the
perPageparameter forGET /v1/campaignsis capped at500. Requests with a higher value are rejected as invalid.
Indeed’s Sponsored Jobs API usage policy
The Sponsored Jobs API usage policy took effect 2024-12-01 in the US and 2026-02-01 in EU markets, GB, CH, CA, AU, NZ, ID, IN, BR, PH, CL, SG, CO, TH, CR, MY, MX, and PA.
The policy protects the Indeed infrastructure by limiting excessive API traffic. Without these limits, a single advertiser — through a typo or an inefficient client — can slow down the system for everyone.
In the US, the Sponsored Jobs API is available only to paying customers and is rate-limited by their job sponsorship spend.
At the end of every billing cycle, customers pay the greater of:
- Monthly Sponsored Jobs campaign spend
- Total monthly API call cost
To prevent accidental misuse and unexpected charges, Indeed also caps API calls per calendar month per advertiser ID. The first $50 of monthly API call costs (or the equivalent in the advertiser's billing currency) is waived.
| Payment method | To calculate the API call limit |
|---|---|
| Credit card | Your monthly API call limit is the greater of your prior month's Sponsored Jobs spend or credit limit, divided by $3 per call. |
One of these methods:
| Your monthly API call limit is the greatest of your prior month's Sponsored Jobs spend, your credit limit, or your IO balance at the beginning of the month, divided by $3 per call. |
Indeed charges all APIs, including free-of-charge APIs, when you call them in employer scope.
Scenario example
Scenario:
- Sponsored Jobs spend is $450.
- Credit limit is $400.
Because Sponsored Jobs spend of $450 is higher than the credit limit of $400, Indeed uses Sponsored Jobs spend to calculate the maximum number of API calls allowed in the month.
| 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 |
Although this is a global policy, Indeed rolls it out by geography in stages.
Usage policy details
The Sponsored Jobs API usage policy took effect 2024-12-01 in the US and 2026-02-01 in EU markets, GB, CH, CA, AU, NZ, ID, IN, BR, PH, CL, SG, CO, TH, CR, MY, MX, and PA.
Paid access
Effective 2026-02-01 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 2024-12-01 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 2026-02-01 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 2026-02-01 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 2024-12-01 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 API call bill at the end of each month, Indeed compares these values:
| Value | Description |
|---|---|
|
|
| |
If value 1 is less than value 2, the customer does not pay an additional API charge.
If value 1 is greater than value 2, the customer pays the difference.
The customer is the billing entity on record that accesses the API.
Indeed waives the first $50, or the equivalent amount in the selected billing currency, of API call costs. Indeed removes this amount automatically before invoice generation. No extra action is required.
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 monthly and lifetime Sponsored Jobs campaign spend, the customer does not pay an additional API charge.
| Item | Charge |
|---|---|
| Sponsored Jobs monthly and lifetime campaigns spend | $500 |
Total API call cost ( | $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 is greater than the monthly and lifetime Sponsored Jobs campaign spend, the customer pays the difference.
| Item | Charge |
|---|---|
| Sponsored Jobs monthly and lifetime campaigns spend | $200 |
Total API call cost ( | $600 |
| Monthly bill for API calls | $600 - $50 fee waiver = $550 |
The Detailed billing report shows the monthly bill for API calls as $600, with this breakdown:
- 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:
| API call | See |
|---|---|
API calls made through ATS JavaScript Plugin. | |
API calls that return an error. That is, the call returns an HTTP | |
API calls to get an OAuth access token, regardless of scope. | |
Get advertiser's API quota usage. Free of charge when you call this operation with an access token that represents an employer. |
To reiterate, these Sponsored Jobs API calls are always charged:
- API calls made in
employerscope, except calls to get an OAuth access token or calls that return an error - Successful calls, which return an HTTP
2XXstatus code
Status codes
Whether Indeed charges for a Sponsored Jobs API call depends on the HTTP status code that the call returns:
| 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 |