Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Indeed Candidates API

Operations for retrieving and managing candidate applications. Part of the Candidate Sync APIs, these endpoints enable ATS partners to fetch candidate and application data from Indeed on behalf of registered employers.

Indeed Candidates API is one of 15 APIs that Indeed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Candidates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, a JSON-LD context, and 1 JSON Schema.

This API exposes 3 operations across 3 paths, and defines 8 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://apis.indeed.com.

3 operations 3 paths 8 schemas 2 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.indeed.com
Authentication
HTTP Bearer, OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 2

Indeed Candidates API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). It supports OAuth 2.0 (OAuth2) using the clientCredentials flow, exposing 3 scopes. By default, every request must be authenticated.

  • BearerAuth — OAuth 2.0 Bearer Token authentication. Obtain access tokens through the Indeed OAuth 2.0 authorization flow using your partner client credentials.
  • OAuth2 — Indeed OAuth 2.0 authentication for partner applications.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Candidates 3

Operations for retrieving and managing candidate applications. Part of the Candidate Sync APIs, these endpoints enable ATS partners to fetch candidate and application data from In…

GET
/v1/employers/{employerId}/candidates
Indeed List Candidates for an Employer
listCandidates 6 params → 200401403404
GET
/v1/employers/{employerId}/candidates/{candidateId}
Indeed Retrieve a Candidate
getCandidate 2 params → 200401403404
PUT
/v1/employers/{employerId}/candidates/{candidateId}/disposition
Indeed Update Candidate Disposition
updateCandidateDisposition 2 params body → 200400401404

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are Candidate (15 properties), Resume (4 properties), DispositionUpdate (4 properties), EeoResponses (4 properties). Each schema is shown below with its type and property counts.

Resume
object
A candidate's resume in multiple formats. The file field contains the uploaded resume document, while text, html, and json fields provide parsed representation…
4 properties
DispositionUpdate
object
An update to the disposition (application status) of a candidate for a specific job posting. Used to sync hiring pipeline status changes back to Indeed.
4 properties 2 required
ScreenerQuestionResponse
object
A candidate's response to a screener question on the job posting.
3 properties
Candidate
object
A job candidate with personal details, resume information, and application data retrieved from Indeed.
15 properties 3 required
EeoResponses
object
Equal Employment Opportunity (EEO) compliance responses provided by the candidate. Available only for US employers with EEO questions enabled.
4 properties
PageInfo
object
Pagination information for list responses.
4 properties
CandidateList
object
A paginated list of candidates.
3 properties
ResumeFile
object
An uploaded resume file.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

indeed-candidates-api-openapi.yml Raw ↑

Other APIs Indeed publishes across the network.

Indeed Job Search API
Indeed Publisher API
Indeed Apply API
Indeed Disposition Sync API
Indeed Sponsored Jobs API
Indeed Job Update API
Indeed Real-time API
Indeed Interview API
Indeed Employer Data API
Indeed Conversion Tracking API
Indeed Employer Registration API
Indeed Retrieve Candidates API