Indeed

opencollection: 1.0.0
info:
  name: Indeed Employer API
  version: 1.0.0
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Employers
    type: folder
  items:
  - info:
      name: Indeed Create an Employer
      type: http
    http:
      method: POST
      url: https://apis.indeed.com/v1/employers
      body:
        type: json
        data: '{}'
    docs: Creates a new employer entity on Indeed. The employer name is required when creating a new employer. An employer
      must be created before job postings can be associated with it. Uses the patchEmployer mutation internally.
  - info:
      name: Indeed Retrieve an Employer
      type: http
    http:
      method: GET
      url: https://apis.indeed.com/v1/employers/:employerId
      params:
      - name: employerId
        value: ats-partner_employer-12345
        type: path
        description: The unique identifier of the employer.
    docs: Retrieves the details of an existing employer by their unique identifier.
  - info:
      name: Indeed Update an Employer
      type: http
    http:
      method: PATCH
      url: https://apis.indeed.com/v1/employers/:employerId
      params:
      - name: employerId
        value: ats-partner_employer-12345
        type: path
        description: The unique identifier of the employer to update.
      body:
        type: json
        data: '{}'
    docs: Updates an existing employer entity on Indeed. Only the fields included in the request body are modified. The employer
      name is optional when updating.
  - info:
      name: Indeed Register Employer for Candidate Sync
      type: http
    http:
      method: PUT
      url: https://apis.indeed.com/v1/employers/:employerId/registration
      params:
      - name: employerId
        value: ''
        type: path
        description: The unique identifier of the employer to register.
      body:
        type: json
        data: '{}'
    docs: Registers an employer for Candidate Sync integration, enabling the retrieval of candidate data and disposition synchronization
      between the ATS and Indeed.
- info:
    name: Candidates
    type: folder
  items:
  - info:
      name: Indeed List Candidates for an Employer
      type: http
    http:
      method: GET
      url: https://apis.indeed.com/v1/employers/:employerId/candidates
      params:
      - name: employerId
        value: ''
        type: path
        description: The unique identifier of the employer.
      - name: status
        value: ''
        type: query
        description: Filter candidates by application status.
      - name: jobPostingId
        value: ''
        type: query
        description: Filter candidates by job posting ID.
      - name: after
        value: ''
        type: query
        description: Cursor for forward pagination.
      - name: first
        value: ''
        type: query
        description: Number of candidates to return (max 100).
      - name: since
        value: ''
        type: query
        description: Return only candidates who applied after this timestamp.
    docs: Retrieves a paginated list of candidates who have applied to jobs posted by the specified employer. Part of the
      Candidate Sync APIs, this endpoint returns candidate and application information including the most recent unacknowledged
      applications.
  - info:
      name: Indeed Retrieve a Candidate
      type: http
    http:
      method: GET
      url: https://apis.indeed.com/v1/employers/:employerId/candidates/:candidateId
      params:
      - name: employerId
        value: ''
        type: path
        description: The unique identifier of the employer.
      - name: candidateId
        value: ''
        type: path
        description: The unique identifier of the candidate application.
    docs: Retrieves the full details of a specific candidate application, including personal information, resume, screener
      question responses, and EEO data if applicable.
  - info:
      name: Indeed Update Candidate Disposition
      type: http
    http:
      method: PUT
      url: https://apis.indeed.com/v1/employers/:employerId/candidates/:candidateId/disposition
      params:
      - name: employerId
        value: ''
        type: path
        description: The unique identifier of the employer.
      - name: candidateId
        value: ''
        type: path
        description: The unique identifier of the candidate application.
      body:
        type: json
        data: '{}'
    docs: Updates the disposition (application status) of a candidate for a specific job posting. This syncs the hiring pipeline
      status from the ATS back to Indeed, enabling accurate reporting and analytics.
- info:
    name: Jobs
    type: folder
  items:
  - info:
      name: Indeed Create Job Postings
      type: http
    http:
      method: POST
      url: https://apis.indeed.com/v1/jobs
      body:
        type: json
        data: '{}'
    docs: Creates one or more job postings on Indeed. Requires a job title, description, location, benefits, and job source
      details. The underlying Indeed API uses the createSourcedJobPostings GraphQL mutation. To update an existing job posting,
      submit the same jobPostingId and sourceName values that were used at creation time.
  - info:
      name: Indeed Retrieve a Job Posting
      type: http
    http:
      method: GET
      url: https://apis.indeed.com/v1/jobs/:jobPostingId
      params:
      - name: jobPostingId
        value: JOB-2024-001
        type: path
        description: The unique identifier of the job posting.
      - name: sourceName
        value: ''
        type: query
        description: The source name to scope the job posting lookup. Required when job posting IDs are not globally unique.
    docs: Retrieves the details of a specific job posting by its unique identifier.
  - info:
      name: Indeed Update a Job Posting
      type: http
    http:
      method: PUT
      url: https://apis.indeed.com/v1/jobs/:jobPostingId
      params:
      - name: jobPostingId
        value: ''
        type: path
        description: The unique identifier of the job posting to update.
      body:
        type: json
        data: '{}'
    docs: Updates an existing job posting on Indeed. The same jobPostingId and sourceName that were used during creation must
      be provided. Uses the createSourcedJobPostings mutation with updated fields.
  - info:
      name: Indeed Expire a Job Posting
      type: http
    http:
      method: DELETE
      url: https://apis.indeed.com/v1/jobs/:jobPostingId
      params:
      - name: jobPostingId
        value: ''
        type: path
        description: The unique identifier of the job posting to expire.
      - name: sourceName
        value: ''
        type: query
        description: The source name used when the job posting was created.
    docs: Expires (closes) a job posting on Indeed, removing it from active search results. This operation cannot be undone;
      a new job posting must be created to relist the position.
  - info:
      name: Indeed List Job Postings for an Employer
      type: http
    http:
      method: GET
      url: https://apis.indeed.com/v1/employers/:employerId/jobs
      params:
      - name: employerId
        value: ''
        type: path
        description: The unique identifier of the employer.
      - name: status
        value: ''
        type: query
        description: Filter job postings by status.
      - name: after
        value: ''
        type: query
        description: Cursor for forward pagination.
      - name: first
        value: ''
        type: query
        description: Number of job postings to return (max 100).
    docs: Retrieves a paginated list of job postings associated with a specific employer.
bundled: true