# OSHA Inspection & Violation Crawler (`jungle_synthesizer/osha-inspection-crawler`) Actor Crawl 4M+ OSHA inspection records from the DOL Enforcement Data API. Extract violations, penalties, SIC/NAICS codes, and case status. Filter by state, date range, and inspection type. - **URL**: https://apify.com/jungle\_synthesizer/osha-inspection-crawler.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Business, Lead generation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ### OSHA Inspection & Violation Crawler Extract workplace safety inspection records from the [OSHA IMIS database](https://www.osha.gov/ords/imis/establishment.html), the official U.S. Department of Labor enforcement data system. This crawler collects structured inspection and violation data covering 4M+ records nationwide, making it ideal for safety compliance research, insurance underwriting, legal analysis, and risk assessment. #### What Data Does It Extract? Each scraped inspection record includes: | Field | Description | |-------|-------------| | `activity_nr` | OSHA inspection activity number (unique ID) | | `estab_name` | Establishment / company name | | `site_address` | Inspection site street address | | `site_city` | Inspection site city | | `site_state` | Inspection site state abbreviation | | `site_zip` | Inspection site ZIP code | | `sic_code` | Standard Industrial Classification code | | `naics_code` | North American Industry Classification System code | | `insp_type` | Inspection type (Planned, Complaint, Referral, Accident, FollowUp) | | `insp_scope` | Inspection scope (Complete, Partial, Records) | | `open_date` | Inspection opening date | | `close_date` | Inspection case close date | | `case_status` | Case status (Open, Closed) | | `viol_type` | Primary violation type (Serious, Willful, Repeat, Other-than-Serious) | | `gravity` | Violation gravity assessment | | `initial_penalty` | Initial assessed penalty amount in USD | | `current_penalty` | Current penalty amount after adjustments in USD | | `nr_exposed` | Number of employees exposed to the hazard | | `abate_date` | Abatement completion date | | `owner_type` | Establishment owner type (Private, Federal, State, Local) | | `safety_hlth` | Whether the violation is Safety or Health related | | `union_status` | Union status of the establishment | | `nr_instances` | Number of violation instances | | `standard` | OSHA standard cited in the violation | #### How to Use Configure the crawler with these input parameters: ```json { "maxItems": 500, "states": ["AZ", "CA"], "dateFrom": "2025-01-01", "dateTo": "2025-06-01", "inspectionType": "Complaint" } ```` #### Input Fields - **maxItems**: Maximum number of inspection records to return. Default: 500. - **states**: Array of US state codes (e.g., `["TX", "CA", "NY"]`). Leave empty to crawl all 50 states plus DC. - **inspectionType**: Filter by inspection type. Options: `Planned`, `Complaint`, `Referral`, `Accident`, `FollowUp`. Leave empty for all types. - **dateFrom**: Start date for inspection date range filter in YYYY-MM-DD format. Leave empty for no lower bound. - **dateTo**: End date for inspection date range filter in YYYY-MM-DD format. Leave empty for no upper bound. - **sicCode**: Filter by Standard Industrial Classification code. Leave empty for all industries. #### How It Works The crawler uses a two-phase approach: 1. **Listing Discovery**: Visits OSHA's industry search pages for each selected state, extracting inspection IDs from result tables and following pagination links. 2. **Detail Extraction**: For each inspection ID, visits the inspection detail page to extract the full record including violation summaries, penalty amounts, cited standards, and abatement dates. Data is sourced from the OSHA IMIS (Integrated Management Information System) database, the official federal record system for workplace safety inspections. #### Output Example ```json { "activity_nr": "1234567", "estab_name": "ABC Manufacturing LLC", "site_address": "123 Industrial Blvd", "site_city": "Phoenix", "site_state": "AZ", "site_zip": "85001", "sic_code": "3599", "naics_code": "332710", "insp_type": "Complaint", "insp_scope": "Complete", "open_date": "2025-03-15", "close_date": "2025-06-20", "case_status": "Closed", "viol_type": "Serious", "gravity": null, "initial_penalty": 15000, "current_penalty": 12500, "nr_exposed": 45, "abate_date": "2025-05-01", "owner_type": "Private", "safety_hlth": "Safety", "union_status": "NonUnion", "nr_instances": 3, "standard": "19100147 A01" } ``` #### Important Notes - **Government Site**: OSHA's IMIS database is a public government website with no authentication required. Proxies are generally not needed. - **Rate Limiting**: The crawler uses conservative concurrency (2-3 concurrent requests) to be respectful of government infrastructure. - **Coverage**: The OSHA IMIS database contains 4M+ inspection records spanning decades across all 50 US states and DC, covering every federally-regulated workplace. - **Data Freshness**: Records are updated as inspections are opened, violations are cited, and cases are closed. Recent inspections may have incomplete violation data if the case is still open. #### Ideal Use Cases - **Insurance Underwriting**: Assess workplace safety risk for prospective clients by reviewing their OSHA inspection history and violation severity. - **Safety Consulting**: Identify companies with recurring violations to target compliance improvement services. - **Legal Research**: Find inspection and penalty data for workplace injury litigation and OSHA citation appeals. - **Regulatory Analysis**: Track enforcement trends by region, industry code, or inspection type over time. - **Due Diligence**: Screen acquisition targets for workplace safety liabilities and outstanding violations. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `states` (type: `array`): Select one or more U.S. states to crawl. Defaults to all states if empty. ## `inspectionType` (type: `string`): Filter by inspection type. Leave empty for all types. ## `dateFrom` (type: `string`): Start date for inspection date range filter (YYYY-MM-DD). Leave empty for no lower bound. ## `dateTo` (type: `string`): End date for inspection date range filter (YYYY-MM-DD). Leave empty for no upper bound. ## `sicCode` (type: `string`): Filter by Standard Industrial Classification code. Leave empty for all industries. ## `maxItems` (type: `integer`): Maximum number of inspection records to return. Set to 0 for unlimited. ## `proxyConfiguration` (type: `object`): Select proxies to be used. Government sites typically do not require proxies. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [ "AZ" ], "maxItems": 500, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [ "AZ" ], "inspectionType": "", "dateFrom": "", "dateTo": "", "sicCode": "", "maxItems": 500, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/osha-inspection-crawler").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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": ["AZ"], "inspectionType": "", "dateFrom": "", "dateTo": "", "sicCode": "", "maxItems": 500, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/osha-inspection-crawler").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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "states": [ "AZ" ], "inspectionType": "", "dateFrom": "", "dateTo": "", "sicCode": "", "maxItems": 500, "proxyConfiguration": { "useApifyProxy": false } }' | apify call jungle_synthesizer/osha-inspection-crawler --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/osha-inspection-crawler", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OSHA Inspection & Violation Crawler", "description": "Crawl 4M+ OSHA inspection records from the DOL Enforcement Data API. Extract violations, penalties, SIC/NAICS codes, and case status. Filter by state, date range, and inspection type.", "version": "1.0", "x-build-id": "jfQ5zRsQLN6XhZuXO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~osha-inspection-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-osha-inspection-crawler", "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/jungle_synthesizer~osha-inspection-crawler/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-osha-inspection-crawler", "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/jungle_synthesizer~osha-inspection-crawler/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-osha-inspection-crawler", "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", "required": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "states": { "title": "State Filter", "type": "array", "description": "Select one or more U.S. states to crawl. Defaults to all states if empty.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] } }, "inspectionType": { "title": "Inspection Type", "enum": [ "", "Planned", "Complaint", "Referral", "Accident", "FollowUp" ], "type": "string", "description": "Filter by inspection type. Leave empty for all types." }, "dateFrom": { "title": "Date From", "type": "string", "description": "Start date for inspection date range filter (YYYY-MM-DD). Leave empty for no lower bound." }, "dateTo": { "title": "Date To", "type": "string", "description": "End date for inspection date range filter (YYYY-MM-DD). Leave empty for no upper bound." }, "sicCode": { "title": "SIC Code", "type": "string", "description": "Filter by Standard Industrial Classification code. Leave empty for all industries." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of inspection records to return. Set to 0 for unlimited.", "default": 500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used. Government sites typically do not require proxies." } } }, "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 } } } } } } } } } } ```