# ZipRecruiter API: Get salary for a job title

> Looks up ZipRecruiter's salary page for a job title in the United States or one US state and returns typical pay, the percentile range and the top-paying cities. Only salary pages that exist publicly are returned.

Unofficial. Not affiliated with or endorsed by ZipRecruiter.

- Page: https://fous.com/methods/ziprecruiter.com/get-salary
- Method: `ziprecruiter.com/get_salary`, version 1
- Website: ziprecruiter.com
- Returns: average annual, hourly, weekly and monthly pay; 25th, 75th and 90th percentile pay; top-paying cities; date; page 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
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `state` | string | no |  | US state name or two-letter code, for example California or CA. Defaults to the whole United States. Default "". |
| `job_title` | string | yes | `"Pharmacist"` | Job title to look up, for example Medical Assistant. |

## Output

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

```json
{
  "job_title": "Pharmacist"
}
```

Its output:

```json
{
  "location": "United States",
  "job_title": "Pharmacist",
  "page_link": "https://www.ziprecruiter.com/Salaries/Pharmacist-Salary",
  "date_shown": "2026-09-28",
  "top_paying_cities": [
    {
      "city": "Soledad, CA",
      "annual_pay_usd": 189532
    },
    {
      "city": "Scotts Valley, CA",
      "annual_pay_usd": 163963
    },
    {
      "city": "Fbi Academy, VA",
      "annual_pay_usd": 158628
    }
  ],
  "average_annual_pay_usd": 126701,
  "average_hourly_pay_usd": 60.91,
  "average_weekly_pay_usd": 2436,
  "average_monthly_pay_usd": 10558,
  "typical_25th_percentile_annual_pay_usd": 116500,
  "typical_75th_percentile_annual_pay_usd": 140000,
  "top_earners_90th_percentile_annual_pay_usd": 149000
}
```

## 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":"ziprecruiter.com/get_salary","input":{"job_title":"Pharmacist"}}'
```

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

- How much does a registered nurse make per year in Texas, and what are the 25th and 90th percentile salaries?
- What's the average hourly pay for a forklift operator across the US according to ZipRecruiter?
- Find typical salary for software engineers in WA, including weekly and monthly pay and the highest-paying cities
- I'm thinking of becoming a dental hygienist in Florida — what's the pay range and which cities pay the most?
- Pull the ZipRecruiter salary figures for Data Analyst nationwide, with the percentile breakdown and a link to the page

## Input schema

```json
{
  "type": "object",
  "required": [
    "job_title"
  ],
  "properties": {
    "state": {
      "type": "string",
      "default": "",
      "description": "US state name or two-letter code, for example California or CA. Defaults to the whole United States."
    },
    "job_title": {
      "type": "string",
      "minLength": 1,
      "description": "Job title to look up, for example Medical Assistant."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "job_title",
    "location",
    "average_annual_pay_usd",
    "average_hourly_pay_usd",
    "average_weekly_pay_usd",
    "average_monthly_pay_usd",
    "typical_25th_percentile_annual_pay_usd",
    "typical_75th_percentile_annual_pay_usd",
    "top_earners_90th_percentile_annual_pay_usd",
    "top_paying_cities",
    "date_shown",
    "page_link"
  ],
  "properties": {
    "location": {
      "type": "string",
      "description": "United States or the selected state."
    },
    "job_title": {
      "type": "string",
      "description": "Job title on the salary page."
    },
    "page_link": {
      "type": "string",
      "description": "Link to this salary page."
    },
    "date_shown": {
      "type": "string",
      "format": "date",
      "description": "Date of the salary estimate."
    },
    "top_paying_cities": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "city",
          "annual_pay_usd"
        ],
        "properties": {
          "city": {
            "type": "string",
            "description": "City name shown on the page."
          },
          "annual_pay_usd": {
            "type": "number",
            "description": "Annual pay in USD."
          }
        },
        "additionalProperties": false
      },
      "description": "Up to 10 top-paying cities shown on this salary page."
    },
    "average_annual_pay_usd": {
      "type": "number",
      "description": "Average annual pay in USD."
    },
    "average_hourly_pay_usd": {
      "type": "number",
      "description": "Average hourly pay in USD."
    },
    "average_weekly_pay_usd": {
      "type": "number",
      "description": "Average weekly pay in USD."
    },
    "average_monthly_pay_usd": {
      "type": "number",
      "description": "Average monthly pay in USD."
    },
    "typical_25th_percentile_annual_pay_usd": {
      "type": "number",
      "description": "25th percentile annual pay in USD."
    },
    "typical_75th_percentile_annual_pay_usd": {
      "type": "number",
      "description": "75th percentile annual pay in USD."
    },
    "top_earners_90th_percentile_annual_pay_usd": {
      "type": "number",
      "description": "90th percentile annual pay in USD."
    }
  },
  "additionalProperties": false
}
```

## See more

- [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.
- [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.
- [PayScale API: Get salary for a job title](https://fous.com/methods/payscale.com/get-salary.md): Gets typical pay for a job title from PayScale research pages. You can narrow it to a country and a city.
- [BLS API: Get occupation wages](https://fous.com/methods/bls.gov/get-occupation-wages.md): Finds the latest published BLS pay and employment for an occupation in the US, a state, or a metro area, and compares it with the national median.
- [PayScale API: Get company pay](https://fous.com/methods/payscale.com/get-company-pay.md): Shows an employer's average annual base salary and its common jobs, with salary ranges, from PayScale public research pages.
- [H1BData API: Search H-1B salary filings](https://fous.com/methods/h1bdata.info/search-salaries.md): Searches H-1B labor condition filings by employer, job title, city and year. Returns salary statistics across all matched filings and the highest-paid filings with case status.
- [BLS API: Get occupation outlook](https://fous.com/methods/bls.gov/get-occupation-outlook.md): Finds the best-matching Occupational Outlook Handbook profile for a job title and returns its pay, entry requirements, jobs and 10-year outlook.
- [Zumper API: Get average rents by city](https://fous.com/methods/zumper.com/get-average-rents.md): Gets Zumper's current median monthly rents for studio through three-bedroom homes in a city, with monthly and yearly percentage changes. National rank is included only when the same-month U.S. national report ranks the city.
- [All ZipRecruiter methods](https://fous.com/methods/ziprecruiter.com.md)