# PayScale API: Get salary for a job title

> Gets typical pay for a job title from PayScale research pages. You can narrow it to a country and a city.

Unofficial. Not affiliated with or endorsed by PayScale.

- Page: https://fous.com/methods/payscale.com/get-salary
- Method: `payscale.com/get_salary`, version 1
- Website: payscale.com
- Returns: median salary, salary/bonus/total ranges, hourly rate, pay by experience, top skills, profile count
- 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 |
|---|---|---|---|---|
| `city` | string | no | `"Chicago"` | City, for example Chicago. |
| `country` | string | no |  | Country, for example United States or Canada. Default "United States". |
| `job_title` | string | yes | `"Office Manager"` | Job title to look up, for example Office Manager. |

## Output

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

```json
{
  "city": "Chicago",
  "job_title": "Office Manager"
}
```

Its output:

```json
{
  "currency": "USD",
  "location": "Chicago, Illinois, United States",
  "page_url": "https://www.payscale.com/research/US/Job=Office_Manager/Salary/88136b32/Chicago-IL",
  "job_title": "Office Manager",
  "top_skills": [
    {
      "name": "Office Management",
      "pay_effect_percent": null
    },
    {
      "name": "Office Administration",
      "pay_effect_percent": null
    },
    {
      "name": "Accounts Receivable",
      "pay_effect_percent": null
    }
  ],
  "bonus_range": {
    "low": 307.86,
    "high": 9845.04
  },
  "last_updated": "2026-07-10",
  "salary_profiles": 182,
  "total_pay_range": {
    "low": 45656.53,
    "high": 84466.79
  },
  "base_salary_range": {
    "low": 48385.65,
    "high": 85068.74
  },
  "average_hourly_rate": 23.87,
  "average_pay_by_experience": {
    "mid_career": 57932.88,
    "entry_level": 47689.7,
    "experienced": 70854.3,
    "late_career": 69536.37,
    "early_career": 56464.67
  },
  "average_base_salary_per_year": 62843.29
}
```

## 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":"payscale.com/get_salary","input":{"city":"Chicago","job_title":"Office Manager"}}'
```

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

- What is the typical median salary for a Software Engineer in Austin, Texas?
- How much does a Registered Nurse make per hour in Canada, Toronto?
- Pay range for an Office Manager in Chicago, United States, including bonuses?
- Look up payscale data on Data Analyst salaries in Seattle with pay by years of experience.
- What are the top skills tied to higher pay for a Mechanical Engineer in Germany, Munich?

## Input schema

```json
{
  "type": "object",
  "required": [
    "job_title"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City, for example Chicago."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country, for example United States or Canada."
    },
    "job_title": {
      "type": "string",
      "minLength": 1,
      "description": "Job title to look up, for example Office Manager."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "job_title",
    "location",
    "currency",
    "average_base_salary_per_year",
    "base_salary_range",
    "average_hourly_rate",
    "bonus_range",
    "total_pay_range",
    "average_pay_by_experience",
    "top_skills",
    "salary_profiles",
    "last_updated",
    "page_url"
  ],
  "properties": {
    "currency": {
      "type": [
        "string",
        "null"
      ]
    },
    "location": {
      "type": "string"
    },
    "page_url": {
      "type": "string"
    },
    "job_title": {
      "type": "string"
    },
    "top_skills": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "pay_effect_percent": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    },
    "bonus_range": {
      "type": "object",
      "properties": {
        "low": {
          "type": [
            "number",
            "null"
          ]
        },
        "high": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "last_updated": {
      "type": [
        "string",
        "null"
      ]
    },
    "salary_profiles": {
      "type": [
        "integer",
        "null"
      ]
    },
    "total_pay_range": {
      "type": "object",
      "properties": {
        "low": {
          "type": [
            "number",
            "null"
          ]
        },
        "high": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "base_salary_range": {
      "type": "object",
      "properties": {
        "low": {
          "type": [
            "number",
            "null"
          ]
        },
        "high": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "average_hourly_rate": {
      "type": [
        "number",
        "null"
      ]
    },
    "average_pay_by_experience": {
      "type": "object",
      "properties": {
        "mid_career": {
          "type": [
            "number",
            "null"
          ]
        },
        "entry_level": {
          "type": [
            "number",
            "null"
          ]
        },
        "experienced": {
          "type": [
            "number",
            "null"
          ]
        },
        "late_career": {
          "type": [
            "number",
            "null"
          ]
        },
        "early_career": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "average_base_salary_per_year": {
      "type": [
        "number",
        "null"
      ]
    }
  }
}
```

## See more

- [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.
- [ZipRecruiter API: Get salary for a job title](https://fous.com/methods/ziprecruiter.com/get-salary.md): 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.
- [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.
- [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.
- [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.
- [Levels.fyi API: Get company salaries by level](https://fous.com/methods/levels.fyi/get-company-salaries.md): Returns Levels.fyi's published 50th-percentile annual pay (total, base, stock, bonus) for each career level at a company and role, optionally in a location, in the location's currency.
- [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.
- [AmbitionBox API: Get company salaries](https://fous.com/methods/ambitionbox.com/get-company-salaries.md): Gets annual salaries by role at an Indian company from AmbitionBox, ordered by number of reports, plus annual averages by experience band when a job title is supplied.
- [All PayScale methods](https://fous.com/methods/payscale.com.md)
