# BLS API: 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. Unofficial. Not affiliated with or endorsed by BLS. - Page: https://fous.com/methods/bls.gov/get-occupation-outlook - Method: `bls.gov/get_occupation_outlook`, version 1 - Website: bls.gov - Returns: profile title, description, median pay, education, jobs, projected growth, openings, SOC code - 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 | |---|---|---|---|---| | `job_title` | string | yes | `"HR specialist"` | Everyday job title to look up, for example registered nurse or HR specialist. | ## Output From a run on Oct 23, 2026. Its input: ```json { "job_title": "HR specialist" } ``` Its output: ```json { "link": "https://www.bls.gov/ooh/business-and-financial/human-resources-specialists.htm", "pay_year": 2025, "soc_code": "13-1071", "pay_currency": "USD", "what_they_do": "Human resources specialists recruit, screen, and interview job applicants and place newly hired workers in jobs. They also may handle compensation and benefits, training, and employee relations.", "profile_title": "Human resources specialists", "number_of_jobs": 939700, "work_experience": "None", "openings_per_year": 73700, "typical_education": "Bachelor's degree", "median_pay_per_hour": 36.51, "median_pay_per_year": 75940, "on_the_job_training": "None", "projection_end_year": 2035, "projection_start_year": 2025, "projected_growth_meaning": "Faster than average", "projected_growth_percent": 6 } ``` ## 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":"bls.gov/get_occupation_outlook","input":{"job_title":"HR specialist"}}' ``` 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 median pay and projected job growth for a software developer according to bls.gov? - I'm thinking about becoming a registered nurse. What education do I need and how many openings are expected over the next decade? - Look up the occupational outlook for an electrician, including typical entry requirements and the SOC code. - How fast is employment expected to grow for HR specialists over the next ten years, and what does the job pay? - Give me the Occupational Outlook Handbook profile for a civil engineering technician: pay, jobs, and growth projections. ## Input schema ```json { "type": "object", "required": [ "job_title" ], "properties": { "job_title": { "type": "string", "description": "Everyday job title to look up, for example registered nurse or HR specialist." } } } ``` ## Output schema ```json { "type": "object", "required": [ "profile_title", "what_they_do", "median_pay_per_year", "median_pay_per_hour", "pay_currency", "pay_year", "typical_education", "work_experience", "on_the_job_training", "number_of_jobs", "projected_growth_percent", "projected_growth_meaning", "projection_start_year", "projection_end_year", "openings_per_year", "link", "soc_code" ], "properties": { "link": { "type": "string", "description": "Official handbook profile link." }, "pay_year": { "type": [ "integer", "null" ], "description": "Year the median pay refers to." }, "soc_code": { "type": [ "string", "null" ], "description": "SOC code, when the profile has a single code.", "x-fous-developer": true }, "pay_currency": { "type": "string", "description": "Currency code for pay, USD." }, "what_they_do": { "type": [ "string", "null" ], "description": "Plain-language description of the work." }, "profile_title": { "type": "string", "description": "Title of the matched handbook profile." }, "number_of_jobs": { "type": [ "integer", "null" ], "description": "Number of jobs in the base projection year." }, "work_experience": { "type": [ "string", "null" ], "description": "Related work experience needed." }, "openings_per_year": { "type": [ "integer", "null" ], "description": "Projected average openings each year." }, "typical_education": { "type": [ "string", "null" ], "description": "Typical education needed to enter." }, "median_pay_per_hour": { "type": [ "number", "null" ], "description": "Median hourly pay in US dollars." }, "median_pay_per_year": { "type": [ "number", "null" ], "description": "Median yearly pay in US dollars." }, "on_the_job_training": { "type": [ "string", "null" ], "description": "On-the-job training needed." }, "projection_end_year": { "type": [ "integer", "null" ], "description": "Ending year of the projection." }, "projection_start_year": { "type": [ "integer", "null" ], "description": "Starting year of the projection." }, "projected_growth_meaning": { "type": [ "string", "null" ], "description": "Handbook description of the growth rate." }, "projected_growth_percent": { "type": [ "number", "null" ], "description": "Projected 10-year employment growth percent." } } } ``` ## See more - [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. - [BLS API: Get unemployment rate](https://fous.com/methods/bls.gov/get-unemployment-rate.md): 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 API: Get inflation rate](https://fous.com/methods/bls.gov/get-inflation-rate.md): 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 API: Convert US dollars between months with CPI](https://fous.com/methods/bls.gov/calculate-inflation.md): 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. - [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. - [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. - [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. - [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. - [All BLS methods](https://fous.com/methods/bls.gov.md)