Get started with the Conversion Tracking API
Send candidate events that take place on your site to Indeed.
By using this API and its documentation and building an integration, you agree to the Additional API Terms and Guidelines.
API overview
#Use the Conversion Tracking API to send Indeed the candidate events that happen on your site. These events include:
- A candidate goes from Indeed to the job application page on your site.
- A candidate applies for a job on your site.
Indeed uses this data to report the value that Indeed provides and to optimize sponsored job campaigns, which improves advertisers' return on investment.
API steps
#1. Authenticate
#To get credentials for this API, use the client credentials grant type (2-legged OAuth).
2. Test
#-
When you set up the integration, set the
testFirebody parameter totruein theEventobject. -
After Indeed receives a few days of data, an Indeed representative shares the daily apply counts for each Indeed tracking token (
ittk). Compare these counts with your records. -
If the counts match your records, set
testFiretofalseor remove it.Your data then appears in the Indeed Analytics Dashboard, and you can use apply-based bidding algorithms such as
targetCPA.
3. Subsequent tests
#To keep testing your integration in your test environment, call the API with testFire set to true in the Event object.
Indeed rate limits
#To protect system stability from unauthorized or unexpected use, Indeed rate limits this API.
The limit is 1,000 requests per IP address every 5 minutes.
See also
#Guide
#REST API reference
#- Add candidate events — Send candidate events that take place on your site to Indeed.