US Labor Market Intelligence Actor

Comprehensive US labor market data aggregation from 5 authoritative public sources: Bureau of Labor Statistics (BLS), Department of Labor (DOL), CDC NIOSH, World Bank, and GDELT.

Features

• BLS Data: Total nonfarm employment, average hourly earnings, unemployment rate, CPI-U
• DOL Wage & Hour: Labor violations and enforcement actions (US-wide)
• CDC NIOSH: Worker health and occupational safety indicators
• World Bank: 5 employment indicators (unemployment, employment ratio, female participation, etc.)
• GDELT News: 30-day labor/employment news sentiment analysis
• Labor Health Score: Composite 0-100 metric (30% unemployment, 25% wage, 20% participation, 15% violations, 10% sentiment)

Input Schema

{
  "state": "CA",              // Two-letter state code (optional, default: US)
  "year": 2024,               // Analysis year 2020-2024 (default: 2024)
  "industryCode": ""          // 6-digit NAICS code (optional, for future use)
}

Output Schema

{
  "query": {
    "state": "CA",
    "year": 2024,
    "timestamp": "2024-04-08T10:30:00Z"
  },
  "bls": {
    "totalEmployment": 158234000,
    "avgHourlyEarnings": 35.21,
    "unemploymentRate": 4.1,
    "cpi": 313.5
  },
  "dol": {
    "violationCount": 12,
    "totalBackWagesUsd": 245000
  },
  "cdc": {
    "recordCount": 1240
  },
  "worldBank": {
    "Unemployment rate": 4.1,
    "Employment to population ratio": 60.4,
    "Female labor force participation": 56.7
  },
  "gdelt": {
    "newsCount30d": 1240,
    "avgTone": -1.2
  },
  "laborHealthScore": 72,
  "sources": [
    {
      "name": "US Bureau of Labor Statistics (BLS)",
      "url": "https://www.bls.gov/",
      "license": "Public Domain (17 U.S.C. § 105)"
    },
    {
      "name": "The World Bank",
      "url": "https://data.worldbank.org/",
      "license": "CC-BY 4.0"
    },
    {
      "name": "The GDELT Project",
      "url": "https://www.gdeltproject.org/",
      "license": "CC-BY 4.0"
    }
  ],
  "disclaimer": "..."
}

Data Sources

1. Bureau of Labor Statistics (BLS)

• Public Domain (17 U.S.C. § 105)
• Endpoint: https://api.bls.gov/publicAPI/v2/timeseries/data/
• Key Series:
  • CES0000000001 - Total Nonfarm Employment
  • CES0500000003 - Average Hourly Earnings
  • LNS14000000 - Unemployment Rate
  • CUUR0000SA0 - Consumer Price Index (CPI-U)
• Rate Limit: 25 requests/day without API key
• Timeout: 15 seconds

2. Department of Labor (DOL)

• Public Domain
• Wage and Hour Division enforcement data
• Gracefully skips if unavailable (fallback to World Bank)
• Timeout: 10 seconds

3. CDC NIOSH

• Public Domain
• Occupational injury and illness data
• Socrata API endpoint with 1000 requests/hour limit
• Gracefully skips if unavailable
• Timeout: 10 seconds

4. World Bank

• Creative Commons Attribution 4.0 (CC-BY 4.0)
• Endpoint: https://api.worldbank.org/v2/country/US/indicator/{code}
• Indicators:
  • SL_UEM_TOTL_ZS - Unemployment rate (% of labor force)
  • SL_EMP_TOTL_SP_ZS - Employment to population ratio
  • SL_GDP_PCAP_EM_KD - GDP per employed person
  • SL_TLF_0714_ZS - Child labor (% of children ages 7-14)
  • SL_TLF_CACT_FE_ZS - Female labor force participation rate
• No authentication required
• 5 parallel requests, timeout: 15 seconds

5. GDELT Project

• Creative Commons Attribution 4.0 (CC-BY 4.0)
• Endpoint: https://api.gdeltproject.org/api/v2/doc/doc
• Queries labor/employment/unemployment news articles (last 30 days)
• Returns sentiment tone (-10 to +10) for each article
• No authentication required
• Timeout: 10 seconds

Labor Health Score Calculation

Composite metric combining 5 weighted indicators:

Score = 50 (baseline) +
  (Unemployment Score - 50) × 0.30 +     // 30% weight (lower unemployment = higher score)
  (Wage Score - 50) × 0.25 +             // 25% weight (higher wages = higher score)
  (Employment Ratio Score - 50) × 0.20 + // 20% weight (higher employment = higher score)
  (Female Participation Score - 50) × 0.10 + // 10% weight
  (News Tone Score - 50) × 0.15          // 15% weight (positive sentiment = higher score)

Range: 0-100 (50 = neutral baseline)

Error Handling

• Individual API failure: Graceful degradation (continue with remaining sources)
• All APIs fail: Returns error notes in output with available data
• Timeout: 10-15 second timeouts per API to prevent hanging
• No PPE charge on error (only on successful query execution)

Pricing (PPE)

• $0.15 USD per query execution
• Charged only on successful completion (await Actor.charge({eventName: 'labor_query'}))
• Apify takes 20%, developer receives 80%

Disclaimer

⚠️ NOT employment, investment, or hiring advice.

This Actor:

• Provides historical data aggregation only
• Does NOT recommend hiring, layoffs, or employment decisions
• Does NOT forecast labor trends or wage changes
• Does NOT constitute legal, HR, or financial advice
• Data must be verified with original sources
• Historical data does not predict future conditions

For employment law questions, consult qualified legal counsel.

Legal Attribution

Data is redistributed under original license terms:

• "Data source: US Bureau of Labor Statistics (BLS)"
• "Data source: US Department of Labor"
• "Data source: US Centers for Disease Control"
• "Data source: The World Bank (CC BY 4.0)"
• "Data source: The GDELT Project (CC BY 4.0)"

Example Usage

Local Testing

npm install
npm start

# Test input (stdin):
{
  "state": "CA",
  "year": 2024
}

Cloud Deployment & Testing

# Push to Apify Cloud
apify push

# Test from cloud (outputs to dataset)
apify call us-labor-market-intelligence --input='{"state":"CA","year":2024}'

# View results
apify dataset --clean

Performance

• Parallel fetching of 5 APIs (Promise.allSettled)
• Individual timeouts: 10-15 seconds per API
• Expected runtime: 5-10 seconds
• Dataset output: ~3-5 KB per execution

Version History

• 1.0.0 (2026-04-08): Initial release with 5-source aggregation, composite scoring, full disclaimers

---

Author: NtriqPRO
License: ISC
Updated: 2026-04-08