BLS Wage Data Scraper - Salary by Occupation API
Pricing
from $1.60 / 1,000 results
BLS Wage Data Scraper - Salary by Occupation API
Search official BLS OEWS wage and salary data by occupation, state, metro area, and industry. Use this scraper/API for HR compensation benchmarking, recruiter salary research, labor-market analysis, workforce planning, and salary-data products. No API key needed for standard lookups.
Pricing
from $1.60 / 1,000 results
Rating
0.0
(0)
Developer
Ava Torres
Maintained by CommunityActor stats
0
Bookmarked
4
Total users
0
Monthly active users
10 days ago
Last modified
Categories
Features
Share
Search official U.S. Bureau of Labor Statistics (BLS) wage, salary, and employment data by occupation, state, metro area, and industry. Data comes from the Occupational Employment and Wage Statistics (OEWS) survey — the authoritative source for HR compensation benchmarking, recruiter salary research, workforce planning, and labor-market analysis.
What You Get
Each run returns a record containing:
| Field | Description |
|---|---|
occupationTitle | Occupation name (e.g. "Software Developers") |
areaTitle | Geographic area (e.g. "National", "California") |
industryTitle | Industry sector (e.g. "All Industries") |
year | Data year |
employment | Total workers employed in this category |
annualMedianWage | Annual median salary (50th percentile) in USD |
annualMeanWage | Annual mean salary in USD |
annual10th | Annual 10th percentile wage |
annual25th | Annual 25th percentile wage |
annual75th | Annual 75th percentile wage |
annual90th | Annual 90th percentile wage |
hourlyMedianWage | Hourly median wage |
hourlyMeanWage | Hourly mean wage |
hourly10th / hourly25th / hourly75th / hourly90th | Hourly percentile wages |
Who Uses This
- HR and compensation teams benchmarking salaries against market data
- Recruiters researching realistic pay ranges before posting jobs
- Job seekers validating offers and negotiating compensation
- Consultants and analysts building compensation models
- Researchers studying labor market trends and wage inequality
How to Use It
Step 1: Find Your Occupation Code (SOC)
The BLS uses Standard Occupational Classification (SOC) codes. Common examples:
| Occupation | SOC Code |
|---|---|
| All Occupations | 000000 |
| Software Developers | 151252 |
| Data Scientists | 152051 |
| Registered Nurses | 291141 |
| Physicians (All) | 291064 |
| Lawyer | 231011 |
| Financial Managers | 113031 |
| General Managers | 111021 |
| Accountants and Auditors | 132011 |
| Market Research Analysts | 131161 |
Enter the code with or without a hyphen (e.g. 15-1252 or 151252).
Step 2: Choose an Area Code
| Area | Code |
|---|---|
| National (all U.S.) | 0000000 |
| California | S0600000 |
| Texas | S4800000 |
| New York | S3600000 |
| Florida | S1200000 |
| Washington | S5300000 |
| Illinois | S1700000 |
| Massachusetts | S2500000 |
| Georgia | S1300000 |
| Colorado | S0800000 |
For Metropolitan Statistical Area (MSA) codes, refer to the BLS OES area definitions.
Step 3: Choose an Industry Code (optional)
Leave blank or use 000000 to get data across all industries. To narrow by sector:
| Industry | Code |
|---|---|
| All Industries | 000000 |
| Information | 510000 |
| Finance and Insurance | 520000 |
| Professional/Scientific/Technical Services | 540000 |
| Health Care and Social Assistance | 620000 |
| Educational Services | 610000 |
| Manufacturing | 310000 |
| Government | 910000 |
Step 4: Set the Year
BLS OEWS data is published annually each May. The most recent release covers May 2025 data. National cross-industry lookups for 2014–2024 use the official year-specific BLS workbooks; current 2025 lookups use the BLS time-series API.
Example Output
Historical 2023 software-developer national wage example:
{"occupationCode": "151252","occupationTitle": "Software Developers","areaCode": "0000000","areaTitle": "National","industryCode": "000000","industryTitle": "All Industries","year": "2023","employment": "1847900","annualMedianWage": "132270","annualMeanWage": "138980","hourlyMedianWage": "63.59","hourlyMeanWage": "66.82","annual10th": "74580","annual25th": "101000","annual75th": "168870","annual90th": "208000","hourly10th": "35.86","hourly25th": "48.56","hourly75th": "81.19","hourly90th": "100.00"}
BLS API Rate Limits
Without a BLS API key, this actor can fetch data for one occupation/area/industry combination per run within the free tier. The BLS rate limit resets every 24 hours.
To increase limits, register for a free BLS API key at data.bls.gov/registrationEngine and enter it in the apiKey field. This raises the daily quota from 25 to 500 series per day.
Data Notes
- Wages marked
*indicate the wage is at or above the BLS top-coded annual value for that release year. - Wages marked
#indicate the hourly wage is below $10/hour. - Not all occupation/area/industry combinations are published. Very small or suppressed cells may return no data.
- OES data is not seasonally adjusted.
- Employment figures are in thousands for broad groups; individual occupation counts are actual numbers.
Source
Data is sourced from the BLS Public Data API v2 and official OEWS annual tables. No third-party data is used.
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
occupationCode | string | no | "151252" | 6-digit Standard Occupational Classification (SOC) code. Hyphens are optional (e.g. '15-1252' or '151252' for Software Developers). Use '... |
occupationTitle | string | no | Human-readable occupation name. Used to label output records. If blank, the actor looks up the title from a built-in SOC code table. | |
areaCode | string | no | "0000000" | 7-character BLS OES area code. Use '0000000' for national data, 'S0600000' for California, etc. See the README for a state/MSA code refer... |
areaTitle | string | no | Human-readable area name. Used to label output records. If blank, the actor looks up the title from a built-in area code table. | |
industryCode | string | no | "000000" | 6-character BLS OES industry code. Use '000000' for all industries combined, '540000' for Professional/Scientific/Technical Services, '62... |
industryTitle | string | no | Human-readable industry name. Used to label output records. | |
year | integer | no | 2025 | The BLS OEWS data year to retrieve. The most recent release is May 2025 data. Historical national cross-industry lookups are supported fr... |
apiKey | string | no | Optional BLS API key from https://data.bls.gov/registrationEngine/. Without a key, the actor is limited to 25 series per day. With a key,... |
Example input
{"occupationTitle": "software","areaCode": "0000000","year": 2024,"occupationCode": "151252","industryCode": "000000"}
Pricing
Pay per event: $0.002 per result plus $0.0001 per run start. No subscription to this Actor is needed. Apify Store discounts apply, so the price per result is lower on Silver, Gold and higher Apify plans. Use Maximum results to cap the cost of each run.
FAQ
How much does BLS Wage Data Scraper - Salary by Occupation API cost?
$0.002 per result plus $0.0001 per run. For example, 1,000 results cost about $2.00. Higher Apify plans get a Store discount.
Do I need an API key or login?
This Actor has an optional or required key field in the input; see the input table above.
Can I run it on a schedule or from code?
Yes. Use Apify Schedules for recurring runs, or call it from the Apify API, the JavaScript or Python client, Make, Zapier, n8n, or any MCP-compatible AI agent.
Why did my run return no results?
Your filters are probably too narrow. Remove a filter or broaden the search, then run again. You only pay the result price for records that are actually saved.
Is the data accurate and up to date?
Each run fetches live data from the source described above, so results are as current as that source. Verify critical records with the original source before acting on them.