Skip to content

BLS API: Get occupation wages

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.

bls.gov (opens in a new tab)Version 1ReadNo sign-in

Unofficial. Not affiliated with or endorsed by BLS.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Location optionallocation

A US state or metro area, for example "Texas" or "Austin, TX". Defaults to the whole United States.

Los Angeles, CA

Default United States.

Job Title, requiredjob_title

Job in everyday words, for example "registered nurse".

registered nurse

Occupation Code optionaloccupation_code

Optional SOC occupation code, for example "29-1141". Overrides job title matching.

(default)

Output

From a run on Oct 23, 2026.
{  "link": "https://data.bls.gov/oes/#/area/0031080/2025",  "currency": "USD",  "location": "Los Angeles-Long Beach-Anaheim, CA",  "soc_code": "29-1141",  "area_code": "0031080",  "survey_period": "May 2025",  "number_employed": 109360,  "occupation_title": "Registered Nurses",  "median_annual_wage": 135560,  "median_hourly_wage": 65.18,  "annual_wage_10th_percentile": 100980,  "annual_wage_90th_percentile": 174200,  "national_median_annual_wage": 97550,  "difference_from_national_median_percent": 38.96}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
bls.gov/get_occupation_wages
Returns
occupation title, location, survey period, employment, median/10th/90th percentile annual wage, median hourly wage, national median, difference

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method bls.gov/get_occupation_wages with the inputs above.

Ask your agent

  • What do electricians make per year in Ohio compared with the national median?
  • How much does a registered nurse earn in the Austin, TX metro area versus the US median wage?
  • Show me median and 90th percentile pay for software developers in California.
  • What is the hourly wage for paralegals in Denver, and how does it stack up nationally?
  • Look up employment numbers and annual wage percentiles for SOC 29-1141 across the whole United States.
  • Finds the best-matching Occupational Outlook Handbook profile for a job title and returns its pay, entry requirements, jobs and 10-year outlook.

    bls.gov/get_occupation_outlook
  • Gets the latest seasonally adjusted unemployment rate and labor-force counts for the United States or a state, with up to 24 months of history.

    bls.gov/get_unemployment_rate
  • Gets the latest U.S. Consumer Price Index inflation for a spending category, with up to 24 recent months of history. Monthly changes are seasonally adjusted; 12-month changes are not.

    bls.gov/get_inflation_rate
  • Converts a US dollar amount from one month or annual average to another using the US city average CPI-U for all items, not seasonally adjusted. Defaults to the latest published month.

    bls.gov/calculate_inflation
  • 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.

    ziprecruiter.com/get_salary
  • Gets typical pay for a job title from PayScale research pages. You can narrow it to a country and a city.

    payscale.com/get_salary
  • 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.com/get_salary
  • Gets a US state's or the federal hourly minimum wage from the Department of Labor, with the tipped cash wage and maximum tip credit, future dated increases, notes and the page's update date.

    dol.gov/get_minimum_wage