# USA OSHA Contractor Risk Lead Finder (`signalcrawl/usa-osha-contractor-risk-leads`) Actor Find U.S. contractor employers in public OSHA inspection data and rank safety, insurance, and vendor-risk leads with violations, penalties, risk scores, and CRM notes. - **URL**: https://apify.com/signalcrawl/usa-osha-contractor-risk-leads.md - **Developed by:** [SignalCrawl](https://apify.com/signalcrawl) (community) - **Categories:** Lead generation, Automation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 osha risk leads This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## USA OSHA Contractor Risk Lead Finder Find US contractor employers in public OSHA inspection and enforcement records, then rank them as safety consulting, insurance loss-control, and vendor-risk leads. This Actor queries official OSHA IMIS Establishment Search pages on `osha.gov`, parses inspection result tables, optionally opens each inspection detail page, and returns normalized OSHA risk leads with citations, penalties, flags, scoring, notes, source URLs, and stable dedupe keys. ### Pricing Target Target pricing: **$2.00 per 1,000 OSHA risk leads**. Primary event: **OSHA risk lead**. ### Why Use This Actor OSHA data is public, but it is not packaged for sales, underwriting, or vendor monitoring workflows. This Actor turns official inspection pages into dedupe-ready leads that can be routed into a CRM, spreadsheet, risk engine, or AI workflow. Use it to: - Find contractors with recent OSHA inspections by trade, state, NAICS, or SIC. - Prioritize employers with violations, serious/repeat/willful flags, or higher penalties. - Build safety consultant outreach lists. - Trigger insurance loss-control reviews. - Monitor contractor/vendor risk before onboarding or renewal. - Run recurring searches and dedupe by OSHA inspection number. ### Data Source The Actor uses official OSHA/DOL public pages: - OSHA Establishment Search: `https://www.osha.gov/ords/imis/establishment.search` - OSHA Inspection Detail: `https://www.osha.gov/ords/imis/establishment.inspection_detail` OSHA states that IMIS data is updated over time and that open cases are especially dynamic. Treat scores and notes as prioritization signals, not legal conclusions. ### Input ```json { "searchTerms": ["roofing", "excavation", "concrete"], "states": ["TX", "FL"], "naicsCodes": ["23"], "startDate": "2024-05-20", "endDate": "2026-05-20", "caseStatus": "all", "violationStatus": "both", "contractorsOnly": true, "includeDetails": true, "minRiskScore": 0, "maxItems": 100, "maxPagesPerQuery": 2, "pageSize": 20 } ```` ### Input Options | Field | Type | Description | |---|---|---| | `searchTerms` | array | Establishment terms searched on OSHA, such as `roofing`, `excavation`, `electrical contractor`, or `concrete`. | | `states` | array | State abbreviations. Leave empty for all states. | | `naicsCodes` | array | Optional parsed NAICS prefix filters, such as `23` or `238160`. | | `sicCodes` | array | Optional parsed SIC prefix filters. | | `startDate` | string | Inspection start date, `YYYY-MM-DD` or `MM/DD/YYYY`. | | `endDate` | string | Inspection end date, `YYYY-MM-DD` or `MM/DD/YYYY`. | | `caseStatus` | string | `all`, `open`, or `closed`. | | `violationStatus` | string | `both`, `yes`, or `no`. | | `contractorsOnly` | boolean | Keeps parsed NAICS codes starting with `23` when a NAICS code is available. | | `includeDetails` | boolean | Opens OSHA detail pages for city, address, citation flags, and penalties. | | `minRiskScore` | integer | Save only leads with risk score at or above this value. | | `maxItems` | integer | Maximum unique leads to save. | | `maxPagesPerQuery` | integer | OSHA result pages per search term/state pair. | | `pageSize` | integer | OSHA rows requested per result page. | ### Output ```json { "platform": "osha.gov", "source": "OSHA IMIS Establishment Search", "employerName": "Acme Roofing LLC", "state": "TX", "city": "Plano", "siteAddress": "Acme Roofing LLC, 1250 Industrial Blvd, Plano, TX 75023", "naics": "238160", "naicsDescription": "Roofing Contractors", "sic": null, "sicDescription": null, "inspectionId": "1850882.015", "activityNumber": "1850882.015", "openDate": "2025-08-20", "caseStatus": "OPEN", "inspectionType": "Referral", "scope": "Partial", "violationCount": 3, "serious": true, "repeat": false, "willful": false, "currentPenalty": 7946, "initialPenalty": 7946, "penaltyScore": 52, "riskScore": 86, "safetyConsultantNote": "Acme Roofing LLC in Plano, TX has 3 OSHA violation(s) tied to serious citation; review fall protection, training, and jobsite controls before outreach.", "insuranceNote": "Use OSHA inspection 1850882.015 as a loss-control trigger; current penalty signal is $7,946 and risk score is 86/100.", "vendorRiskNote": "Vendor risk review should verify corrective actions, citation status, EMR/loss runs, and subcontractor safety controls for Acme Roofing LLC.", "matchedTerm": "roofing", "dedupeKey": "osha:1850882.015", "url": "https://www.osha.gov/ords/imis/establishment.inspection_detail?id=1850882.015", "sourceUrl": "https://www.osha.gov/ords/imis/establishment.inspection_detail?id=1850882.015", "sourceSearchUrl": "https://www.osha.gov/ords/imis/establishment.search?...", "scrapedAt": "2026-05-20T00:00:00+00:00" } ``` ### Scoring `penaltyScore` is based on the highest parsed current or initial OSHA penalty total for the inspection. `riskScore` combines: - Violation count. - Serious, repeat, and willful citation flags. - Inspection type signals such as complaint, referral, accident, fatality/catastrophe, or planned inspection. - Inspection scope. - Penalty score. The score is intentionally transparent and deterministic so users can sort, filter, and override it downstream. ### Common Run Patterns Roofing fall protection outreach: ```json { "searchTerms": ["roofing", "fall protection"], "states": ["TX", "FL"], "naicsCodes": ["238160"], "violationStatus": "yes", "includeDetails": true, "minRiskScore": 55 } ``` Excavation insurance watchlist: ```json { "searchTerms": ["excavation", "trenching", "site work"], "states": ["CA", "AZ", "NV"], "naicsCodes": ["238910"], "includeDetails": true, "minRiskScore": 45 } ``` Vendor-risk construction screening: ```json { "searchTerms": ["construction", "concrete", "electrical contractor"], "states": [], "naicsCodes": ["23"], "violationStatus": "yes", "contractorsOnly": true, "minRiskScore": 60 } ``` ### Notes And Limitations - This Actor uses public OSHA pages and does not require private credentials. - OSHA result pages are HTML, not a stable JSON API; parsing is defensive and may need maintenance if OSHA changes page layout. - OSHA indicates that open cases can change and citation details may lag. - Employer names can be similar; verify address and inspection detail before taking action. - Risk notes are workflow aids for lead prioritization, insurance review, and vendor-risk triage, not legal advice. ### Local QA ```bash python tests/qa_harness.py python -m compileall src tests ``` The QA harness covers result table parsing, detail page parsing, penalty aggregation, score creation, filter logic, and JSON schema/example validity. # Actor input Schema ## `searchTerms` (type: `array`): Terms searched in OSHA Establishment Search. Use trade words like roofing, excavation, concrete, electrical contractor, demolition, scaffolding. ## `states` (type: `array`): US state abbreviations. Leave empty to search all states. ## `naicsCodes` (type: `array`): Optional prefix filters applied after parsing, for example 23 for construction or 238160 for roofing contractors. ## `sicCodes` (type: `array`): Optional SIC prefix filters applied after parsing. ## `startDate` (type: `string`): Inspection opened on or after this date. OSHA accepts date ranges up to 10 years; YYYY-MM-DD or MM/DD/YYYY. ## `endDate` (type: `string`): Inspection opened on or before this date. YYYY-MM-DD or MM/DD/YYYY. ## `caseStatus` (type: `string`): OSHA case status filter. ## `violationStatus` (type: `string`): OSHA violation filter. ## `contractorsOnly` (type: `boolean`): Keep only parsed NAICS codes starting with 23 when a NAICS code is available. ## `includeDetails` (type: `boolean`): Visit each OSHA inspection detail page for city, address, NAICS description, citation types, and penalties. ## `minRiskScore` (type: `integer`): Only save leads at or above this risk score. ## `maxItems` (type: `integer`): Maximum unique OSHA risk leads to save. ## `maxPagesPerQuery` (type: `integer`): Maximum OSHA search result pages for each term/state pair. ## `pageSize` (type: `integer`): OSHA result rows requested per page. ## Actor input object example ```json { "searchTerms": [ "roofing", "excavation", "concrete", "electrical contractor" ], "states": [ "TX", "FL", "CA" ], "naicsCodes": [ "23" ], "sicCodes": [], "startDate": "2024-05-20", "endDate": "2026-05-20", "caseStatus": "all", "violationStatus": "yes", "contractorsOnly": true, "includeDetails": true, "minRiskScore": 0, "maxItems": 100, "maxPagesPerQuery": 2, "pageSize": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "roofing", "excavation", "concrete", "electrical contractor" ], "states": [ "TX", "FL", "CA" ], "naicsCodes": [ "23" ], "sicCodes": [] }; // Run the Actor and wait for it to finish const run = await client.actor("signalcrawl/usa-osha-contractor-risk-leads").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": [ "roofing", "excavation", "concrete", "electrical contractor", ], "states": [ "TX", "FL", "CA", ], "naicsCodes": ["23"], "sicCodes": [], } # Run the Actor and wait for it to finish run = client.actor("signalcrawl/usa-osha-contractor-risk-leads").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "roofing", "excavation", "concrete", "electrical contractor" ], "states": [ "TX", "FL", "CA" ], "naicsCodes": [ "23" ], "sicCodes": [] }' | apify call signalcrawl/usa-osha-contractor-risk-leads --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=signalcrawl/usa-osha-contractor-risk-leads", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "USA OSHA Contractor Risk Lead Finder", "description": "Find U.S. contractor employers in public OSHA inspection data and rank safety, insurance, and vendor-risk leads with violations, penalties, risk scores, and CRM notes.", "version": "0.1", "x-build-id": "b8SMoMguzqCHn8Yfe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalcrawl~usa-osha-contractor-risk-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalcrawl-usa-osha-contractor-risk-leads", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/signalcrawl~usa-osha-contractor-risk-leads/runs": { "post": { "operationId": "runs-sync-signalcrawl-usa-osha-contractor-risk-leads", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/signalcrawl~usa-osha-contractor-risk-leads/run-sync": { "post": { "operationId": "run-sync-signalcrawl-usa-osha-contractor-risk-leads", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Employer search terms", "type": "array", "description": "Terms searched in OSHA Establishment Search. Use trade words like roofing, excavation, concrete, electrical contractor, demolition, scaffolding.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "US state abbreviations. Leave empty to search all states.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS filters", "type": "array", "description": "Optional prefix filters applied after parsing, for example 23 for construction or 238160 for roofing contractors.", "items": { "type": "string" } }, "sicCodes": { "title": "SIC filters", "type": "array", "description": "Optional SIC prefix filters applied after parsing.", "items": { "type": "string" } }, "startDate": { "title": "Start date", "type": "string", "description": "Inspection opened on or after this date. OSHA accepts date ranges up to 10 years; YYYY-MM-DD or MM/DD/YYYY.", "default": "2024-05-20" }, "endDate": { "title": "End date", "type": "string", "description": "Inspection opened on or before this date. YYYY-MM-DD or MM/DD/YYYY.", "default": "2026-05-20" }, "caseStatus": { "title": "Case status", "enum": [ "all", "open", "closed" ], "type": "string", "description": "OSHA case status filter.", "default": "all" }, "violationStatus": { "title": "Violation status", "enum": [ "both", "yes", "no" ], "type": "string", "description": "OSHA violation filter.", "default": "yes" }, "contractorsOnly": { "title": "Contractors only", "type": "boolean", "description": "Keep only parsed NAICS codes starting with 23 when a NAICS code is available.", "default": true }, "includeDetails": { "title": "Fetch inspection details", "type": "boolean", "description": "Visit each OSHA inspection detail page for city, address, NAICS description, citation types, and penalties.", "default": true }, "minRiskScore": { "title": "Minimum risk score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only save leads at or above this risk score.", "default": 0 }, "maxItems": { "title": "Max OSHA risk leads", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum unique OSHA risk leads to save.", "default": 100 }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum OSHA search result pages for each term/state pair.", "default": 2 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "OSHA result rows requested per page.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```