Skip to content

BLS API

BLS (bls.gov) has 5 public methods: get occupation outlook, convert US dollars between months with CPI, get occupation wages, get inflation rate and get unemployment rate. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

bls.gov (opens in a new tab)

Unofficial. Not affiliated with or endorsed by BLS.

Methods

5

  • Get occupation outlook

    Finds the best-matching Occupational Outlook Handbook profile for a job title and returns its pay, entry requirements, jobs and 10-year outlook.

    Returns profile title, description, median pay, education, jobs, projected growth, openings, SOC code

    Readbls.gov/get_occupation_outlook

  • Convert US dollars between months with CPI

    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.

    Returns adjusted amount, cumulative inflation percent, CPI values, plain-English sentence

    Readbls.gov/calculate_inflation

  • 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.

    Returns occupation title, location, survey period, employment, median/10th/90th percentile annual wage, median hourly wage, national median, difference

    Readbls.gov/get_occupation_wages

  • Get inflation 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.

    Returns latest month, 12-month and 1-month percent changes, core inflation, release dates, history

    Readbls.gov/get_inflation_rate

  • Get unemployment rate

    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.

    Returns unemployment rate, change from previous month, labor force, employed, unemployed, release date, BLS series IDs, optional monthly history

    Readbls.gov/get_unemployment_rate