---
title: "Search job postings on Indeed"
method: POST
path: "/indeed/search-job-postings"
tags: ["Indeed"]
---

# Search job postings on Indeed

`POST /indeed/search-job-postings`

## Request

- Base URL: `https://api.exfunc.dev`
- URL: `https://api.exfunc.dev/indeed/search-job-postings`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/carvedai/apis/exfunc-apis/docs/indeed/search-job-postings/post.ts> (a function with typed inputs; its response is checked against the schema)

Search job postings on Indeed for a given query

## Request body

- object
  - `query` string: The search query for job postings
  - `location` string: Location to filter job postings
  - `date_posted` 'Any time' | 'Past 24 hours' | 'Past 3 days' | 'Past Week' | 'Past Month': Filter for job postings based on when they were posted
  - `next_token` string, nullable: Next token for pagination

## Response `200`

SearchJobPostings API successful response

- object
  - `job_postings` IndeedJobPosting[]
    - `url` string, uri: The URL link to the Indeed job posting
    - `title` string: The title of the job posting
    - `location` string: The location of the job posting
    - `description` string: Detailed description of the job posting
    - `job_type` string, nullable: Type of job (e.g., FULL_TIME, PART_TIME, CONTRACT)
    - `date_posted` string, date-time: Date when the job was posted
    - `company_name` string, nullable: Name of the company offering the job
    - `company_url` string, uri, nullable: URL to the company page on Indeed
    - `company_website_url` string, uri, nullable: URL to the company's website
    - `company_location` string, nullable: The location of the company
    - `company_industry` string, nullable: The industry of the company
    - `company_size` string, nullable: The size range of the company
    - `company_revenue` string, nullable: The revenue (ARR) of the company
    - `company_overview` string, nullable: The overview of the company
    - `salary` object, nullable: Salary details for the job posting
      - `currency` string, nullable
      - `period` string, nullable
      - `percentiles` object
        - `p0` number, nullable
        - `p100` number, nullable
  - `next_token` string: Next token for pagination

## Other responses

- `400`: User error response
- `500`: Server error response

## Changes

- **2025-01-04** `0ce1a6ba7d90`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/indeed/search-job-postings/post.md)

---

[API](https://skmtc.dev/carvedai/apis/exfunc-apis.md) - [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/carvedai/apis/exfunc-apis/revisions/22587fdf9a5e?raw)