# Indeed API: Search jobs

> Searches open Indeed jobs by keywords, location, country, posting age and job type, returning public first-page results in displayed order.

Unofficial. Not affiliated with or endorsed by Indeed.

- Page: https://fous.com/methods/indeed.com/search-jobs
- Method: `indeed.com/search_jobs`, version 1
- Website: indeed.com
- Returns: title, company, location, salary range, job type, posted date, snippet, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `what` | string | yes | `"payroll specialist"` | Job title or search words, for example payroll specialist. |
| `where` | string | no | `"Chicago, IL"` | City, state, country or remote, for example Chicago, IL. Default "". |
| `country` | string | no | `"United States"` | Country to search, for example United Kingdom. Supported: United States, United Kingdom, Canada, Australia, India, Ireland, New Zealand, Singapore, Germany, France, Netherlands, Spain, Italy, United Arab Emirates. Default "United States". |
| `job_type` | string | no | `"any"` | Kind of work, for example full_time. One of "full_time", "part_time", "contract", "temporary", "internship", "any". Default "any". |
| `max_results` | integer | no | `25` | Maximum number of jobs to return. Public first-page searches may provide fewer. Default 25. |
| `posted_within` | string | no | `"last_7_days"` | How recently the job was posted, for example last_7_days. One of "last_24_hours", "last_3_days", "last_7_days", "last_14_days", "any". Default "last_7_days". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "what": "payroll specialist",
  "where": "Chicago, IL",
  "country": "United States",
  "job_type": "any",
  "max_results": 25,
  "posted_within": "last_7_days"
}
```

Its output:

```json
{
  "jobs": [
    {
      "title": "Benefits Admin Specialist",
      "salary": "$61,600 - $92,400 a year",
      "company": "Exelon",
      "currency": "USD",
      "job_link": "https://www.indeed.com/viewjob?jk=e1f709b6a601899b",
      "job_type": null,
      "location": "Chicago, IL 60603",
      "pay_period": "year",
      "posted_date": "2026-10-31",
      "maximum_salary": 92400,
      "minimum_salary": 61600,
      "work_arrangement": null,
      "short_description": "Oversee benefits-related processing of deductions, arrears, refunds, and payroll reconciliations, making and validating corrections as necessary."
    },
    {
      "title": "Sr. Payroll Analyst",
      "salary": "$85,000 - $136,000 a year",
      "company": "Woodward, Inc.",
      "currency": "USD",
      "job_link": "https://www.indeed.com/viewjob?jk=c7ffe6843817f00b",
      "job_type": null,
      "location": "Chicago, IL",
      "pay_period": "year",
      "posted_date": "2026-10-27",
      "maximum_salary": 136000,
      "minimum_salary": 85000,
      "work_arrangement": null,
      "short_description": "Handle payroll across multiple countries, including the United States and Canada, ensuring compliance with international payroll regulations."
    },
    {
      "title": "Payroll Specialist",
      "salary": null,
      "company": "ProPayHR",
      "currency": null,
      "job_link": "https://www.indeed.com/viewjob?jk=1b31f78006c971e9",
      "job_type": null,
      "location": "Evanston, IL 60202",
      "pay_period": null,
      "posted_date": "2026-10-30",
      "maximum_salary": null,
      "minimum_salary": null,
      "work_arrangement": null,
      "short_description": "Required: 3+ years of payroll processing experience with hands-on multi-state payroll expertise. Payroll Systems – Utilize Paycor and other payroll…"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"indeed.com/search_jobs","input":{"what":"payroll specialist","where":"Chicago, IL","country":"United States","job_type":"any","max_results":25,"posted_within":"last_7_days"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find remote data analyst jobs posted in the last 3 days in the United Kingdom, full-time, up to 40 results
- Show me part-time barista openings in Dublin, Ireland from the past week
- Look up contract nurse positions in Toronto, Canada, limit 15 listings
- Any software engineer internships in Berlin, Germany posted in the last 24 hours on Indeed?
- I need warehouse associate jobs near Austin, TX with salary info, temporary or full-time, last 14 days

## Input schema

```json
{
  "type": "object",
  "required": [
    "what"
  ],
  "properties": {
    "what": {
      "type": "string",
      "minLength": 1,
      "description": "Job title or search words, for example payroll specialist."
    },
    "where": {
      "type": "string",
      "default": "",
      "description": "City, state, country or remote, for example Chicago, IL."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country to search, for example United Kingdom. Supported: United States, United Kingdom, Canada, Australia, India, Ireland, New Zealand, Singapore, Germany, France, Netherlands, Spain, Italy, United Arab Emirates."
    },
    "job_type": {
      "enum": [
        "full_time",
        "part_time",
        "contract",
        "temporary",
        "internship",
        "any"
      ],
      "type": "string",
      "default": "any",
      "description": "Kind of work, for example full_time."
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of jobs to return. Public first-page searches may provide fewer."
    },
    "posted_within": {
      "enum": [
        "last_24_hours",
        "last_3_days",
        "last_7_days",
        "last_14_days",
        "any"
      ],
      "type": "string",
      "default": "last_7_days",
      "description": "How recently the job was posted, for example last_7_days."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "jobs"
  ],
  "properties": {
    "jobs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "salary": {
            "type": [
              "string",
              "null"
            ]
          },
          "company": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "job_link": {
            "type": "string"
          },
          "job_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "pay_period": {
            "type": [
              "string",
              "null"
            ]
          },
          "posted_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "maximum_salary": {
            "type": [
              "number",
              "null"
            ]
          },
          "minimum_salary": {
            "type": [
              "number",
              "null"
            ]
          },
          "work_arrangement": {
            "type": [
              "string",
              "null"
            ]
          },
          "short_description": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [Indeed API: Get salary for a job title](https://fous.com/methods/indeed.com/get-salary.md): Finds the typical pay for a job title in the United States or a U.S. city or state on Indeed's public salary pages, with the number of reported salaries, the last update date, and the top-paying cities and companies when shown.
- [Indeed API: Get company reviews](https://fous.com/methods/indeed.com/get-company-reviews.md): Looks up a company on Indeed and returns its overall employee rating, number of ratings, category ratings and CEO approval.
- [LinkedIn API: Search jobs](https://fous.com/methods/linkedin.com/search-jobs.md): Searches public LinkedIn job listings by keywords and location, with optional date, seniority, employment type and company filters.
- [SEEK API: Search jobs](https://fous.com/methods/seek.com.au/search-jobs.md): Finds current SEEK jobs in Australia by keywords, with optional location, work type and posting window. Results follow SEEK search order; some promoted listings may appear outside the selected posting window.
- [ZipRecruiter API: Search jobs](https://fous.com/methods/ziprecruiter.com/search-jobs.md): Finds open ZipRecruiter jobs by keywords and location, with distance and posting-date filters. Returns up to 100 public listings in search order; details that are not shown are null.
- [Remote OK API: Search remote jobs](https://fous.com/methods/remoteok.com/search-jobs.md): Searches Remote OK jobs by role or skill. Results can be filtered by listed region and by minimum annual USD salary.
- [myworkdayjobs.com API: List company jobs on Workday](https://fous.com/methods/myworkdayjobs.com/list-company-jobs.md): Lists a company's public Workday jobs, optionally narrowed by keywords and location, newest first with exact posting dates among up to 500 checked postings. Workday may cap the reported total at 2,000; location totals reflect checked postings.
- [LinkedIn API: List company jobs](https://fous.com/methods/linkedin.com/list-company-jobs.md): Lists open LinkedIn jobs posted by a named company, with optional location and result limit. Workplace type is returned only when LinkedIn displays it.
- [All Indeed methods](https://fous.com/methods/indeed.com.md)