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 Employers API

Operations for creating and managing employer profiles on Indeed. Employer entities must be created before job postings can be associated with them. Supports global attributes such as employer name and type, as well as country-specific attributes like website URL and phone number.

Indeed Employers 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 Employers. 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 4 operations across 3 paths, and defines 9 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.

4 operations 3 paths 9 schemas 1 GET1 PATCH1 POST1 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 Employers 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 4

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

Employers 4

Operations for creating and managing employer profiles on Indeed. Employer entities must be created before job postings can be associated with them. Supports global attributes suc…

POST
/v1/employers
Indeed Create an Employer
createEmployer body → 201400401403409429
GET
/v1/employers/{employerId}
Indeed Retrieve an Employer
getEmployer 1 param → 200401403404
PATCH
/v1/employers/{employerId}
Indeed Update an Employer
updateEmployer 1 param body → 200400401403404429
PUT
/v1/employers/{employerId}/registration
Indeed Register Employer for Candidate Sync
registerEmployerForCandidateSync 1 param body → 200401404

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are Address (6 properties), Employer (6 properties), EmployerRegistration (4 properties), CountrySpecificAttributes (4 properties). Each schema is shown below with its type and property counts.

LocaleSpecificAttributes
object
Locale-specific employer attributes for multilingual support.
3 properties
Address
object
A physical address.
6 properties
PatchEmployerInput
object
Input for creating or updating an employer on Indeed.
3 properties 1 required
Employer
object
An employer entity on Indeed representing a company or organization that posts jobs and manages candidates.
6 properties 2 required
EmployerRegistration
object
Registration of an employer for Candidate Sync integration, enabling candidate data synchronization between the ATS and Indeed.
4 properties
EmployerAttributes
object
Additional attributes for an employer, including both global and country-specific settings.
3 properties
PatchEmployerPayload
object
Response payload from a successful employer create or update operation.
3 properties
ApiError
object
An error returned by the Indeed API.
3 properties
CountrySpecificAttributes
object
Country-scoped employer attributes. Provide an ISO 3166-1 two-letter country code to specify the country.
4 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

indeed-employers-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