# OSHA Inspections and Violations Scraper (`automation-lab/osha-inspections-violations-scraper`) Actor Search OSHA IMIS inspection records by company, state, date range, case status, and violations. Export inspection details, penalties, and citations. - **URL**: https://apify.com/automation-lab/osha-inspections-violations-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Inspections and Violations Scraper Search public OSHA IMIS establishment records and export inspection history, violation counts, penalty totals, citation rows, and source URLs. Use this actor when you need repeatable OSHA enforcement data for compliance monitoring, EHS research, insurance underwriting, legal discovery, journalism, or B2B safety-remediation lead generation. ### What does OSHA Inspections and Violations Scraper do? This actor queries the public OSHA establishment search at `osha.gov/ords/imis/establishment.search`. It accepts a company or establishment keyword, state, date range, case-status filter, violation filter, and result limit. For every matching inspection, it saves a structured dataset row. When detail expansion is enabled, it follows each OSHA inspection detail link and enriches the row with office, address, case status, penalty totals, and violation item details. The actor is HTTP-first and does not use a browser. No OSHA login is required. No proxy is configured by default. ### Who is it for? #### EHS and compliance teams Monitor your own OSHA inspection history across facilities. Compare open and closed cases by state and date range. Export penalty and citation details for internal review. #### Insurance and risk teams Screen workplace-safety enforcement history for businesses, facilities, vendors, or insured accounts. Pull repeatable datasets before renewal or underwriting decisions. #### Consultants and safety vendors Find companies with recent inspections, accidents, complaints, or violations. Use inspection metadata to prioritize outreach. #### Journalists and researchers Collect public enforcement records for a company, industry keyword, or state. Keep source URLs for fact-checking and citation. #### Legal and labor teams Review inspection status, case closure, penalties, standards cited, and citation events. Export rows for document review or downstream analysis. ### Why use this actor? OSHA records are public, but the IMIS pages are built for manual browsing. This actor turns those pages into clean JSON, CSV, Excel, XML, or API-ready data. It also preserves the OSHA source URLs so every row can be audited. The default input is small enough for a quick test run. Larger date ranges can be crawled by increasing `maxItems`. ### Data you can extract | Field | Description | | --- | --- | | `inspectionNumber` | OSHA inspection/activity number | | `establishmentName` | Establishment name from OSHA results | | `dateOpened` | Inspection open date | | `state` | State code | | `reportId` | OSHA report/RID value | | `inspectionType` | Complaint, accident, programmed, referral, or other OSHA type | | `scope` | Partial/full inspection scope | | `sic` | SIC code when OSHA provides it | | `naics` | NAICS code when OSHA provides it | | `violations` | Result-page violation count | | `oshaOffice` | OSHA office from the detail page | | `caseStatus` | Open/closed case status | | `siteAddress` | Facility/site address | | `mailingAddress` | Mailing address | | `unionStatus` | Union status from OSHA detail page | | `ownership` | Private/public ownership classification | | `safetyHealth` | Safety or health classification | | `closeConferenceDate` | Close conference date | | `caseClosedDate` | Case closed date | | `initialPenaltyTotalUsd` | Initial total penalty from violation summary | | `currentPenaltyTotalUsd` | Current total penalty from violation summary | | `violationItems` | Citation rows with standard, type, dates, penalties, event, and detail URL | | `detailUrl` | OSHA inspection detail page | | `searchUrl` | OSHA search URL used for the row | | `scrapedAt` | Timestamp when the actor saved the row | ### How much does it cost to scrape OSHA inspections? This actor uses pay-per-event pricing. There is a small start fee per run. Each saved OSHA inspection record is charged as one `item` event. You control spend with `maxItems`. The default prefill saves a small sample before you scale to larger date ranges. ### Quick start 1. Enter a company or establishment keyword, for example `amazon`. 2. Choose a state such as `CA`, or use `all` for nationwide results. 3. Set the inspection date range. 4. Keep `includeViolationDetails` enabled if you need addresses, penalties, and citation rows. 5. Set `maxItems` to the number of inspections you want. 6. Run the actor. 7. Download the dataset as JSON, CSV, Excel, XML, RSS, or HTML. ### Input options #### `establishment` Company, employer, or establishment keyword. Examples: `amazon`, `tesla`, `walmart`, `construction`, `warehouse`. #### `state` Two-letter state code, or `all`. Examples: `CA`, `TX`, `NY`, `all`. #### `startDate` and `endDate` Inspection open-date range. Use `YYYY-MM-DD`. #### `caseStatus` Choose `all`, `open`, or `closed`. #### `violationsExist` Choose `both`, `yes`, or `no`. Use `yes` when you only want inspections with violations. #### `maxItems` Maximum inspection records to save. #### `includeViolationDetails` When enabled, the actor follows each detail page. This adds richer fields but makes one extra HTTP request per inspection. #### `requestDelayMillis` A polite delay between OSHA requests. Increase it for very large searches. #### `startUrls` Optional direct OSHA `establishment.search` URLs. Use this when you already created a query in OSHA IMIS and want the actor to crawl that result set. ### Example input ```json { "establishment": "amazon", "state": "CA", "startDate": "2024-01-01", "endDate": "2024-12-31", "caseStatus": "all", "violationsExist": "both", "maxItems": 25, "includeViolationDetails": true, "requestDelayMillis": 250 } ```` ### Example output ```json { "inspectionNumber": "1780602.015", "establishmentName": "Amazon Vupc", "dateOpened": "10/09/2024", "state": "CA", "reportId": "0950644", "inspectionType": "Complaint", "scope": "Partial", "naics": "493110", "violations": null, "oshaOffice": "Monrovia District Office", "caseStatus": "CLOSED", "siteAddress": "Amazon Vupc 4815 S. Hellman Ave Ontario, CA 91762", "currentPenaltyTotalUsd": null, "violationItems": [], "detailUrl": "https://www.osha.gov/ords/imis/establishment.inspection_detail?id=1780602.015", "searchUrl": "https://www.osha.gov/ords/imis/establishment.search?...", "scrapedAt": "2026-06-30T04:20:27.250Z" } ``` ### Tips for better OSHA searches Use the legal entity name when possible. Try common variants such as `Amazon`, `Amazon.com Services`, and facility brand names. Use a state filter for faster, cleaner results. Use `violationsExist: yes` when you only want citation-heavy records. Use a wider date range for low-volume establishments. Disable detail expansion when you only need a quick inspection index. ### Pagination behavior OSHA result pages usually show 20 inspections per page. The actor follows OSHA page links until it reaches `maxItems`. It avoids visiting the same result URL twice. ### Integrations Use this actor in Apify datasets, webhooks, integrations, or API clients. Common workflows include: - Weekly OSHA monitoring for a list of target companies. - Compliance dashboards in Google Sheets or BI tools. - Lead enrichment for safety vendors. - Insurance underwriting research before renewal. - Investigative datasets that combine OSHA records with company lists. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/osha-inspections-violations-scraper').call({ establishment: 'amazon', state: 'CA', startDate: '2024-01-01', endDate: '2024-12-31', maxItems: 25, }); console.log(run.defaultDatasetId); ``` #### Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('automation-lab/osha-inspections-violations-scraper').call(run_input={ 'establishment': 'amazon', 'state': 'CA', 'startDate': '2024-01-01', 'endDate': '2024-12-31', 'maxItems': 25, }) print(run['defaultDatasetId']) ``` #### cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~osha-inspections-violations-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"establishment":"amazon","state":"CA","startDate":"2024-01-01","endDate":"2024-12-31","maxItems":25}' ``` ### MCP usage Use the Apify MCP server to run this actor from Claude Desktop or Claude Code. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/osha-inspections-violations-scraper ``` Claude Code setup: ```bash claude mcp add apify-osha-inspections "https://mcp.apify.com/?tools=automation-lab/osha-inspections-violations-scraper" ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-osha-inspections": { "url": "https://mcp.apify.com/?tools=automation-lab/osha-inspections-violations-scraper" } } } ``` Example prompts: - "Run the OSHA inspections scraper for Amazon in California in 2024 and summarize accident inspections." - "Find OSHA inspections with violations for Tesla in Texas since 2023." - "Export current penalties and citation standards for this establishment list." ### FAQ #### Is OSHA login required? No. The actor reads public OSHA IMIS pages available on `osha.gov`. #### Can I scrape only inspections with violations? Yes. Set `violationsExist` to `yes` and keep `includeViolationDetails` enabled to export citation and penalty fields. ### Troubleshooting #### I got zero results Check spelling and try a shorter establishment keyword. Try `state: all` or a wider date range. OSHA may store legal names differently from brand names. #### Some penalty fields are null Not every inspection has violations or penalty data. The actor keeps null values instead of inventing data. #### Runs are slower with detail expansion Detail expansion makes one extra OSHA request per inspection. Disable `includeViolationDetails` for a faster inspection index. ### Data freshness The actor reads live public OSHA IMIS pages during each run. It does not cache records between runs. ### Legality and ethics This actor extracts public OSHA government web pages. Use the data responsibly. Respect OSHA source attribution and verify critical records on the original OSHA detail URL. Do not use the output to make automated decisions without human review. ### Related scrapers - https://apify.com/automation-lab/website-contact-finder - https://apify.com/automation-lab/company-email-finder - https://apify.com/automation-lab/google-maps-lead-finder ### Changelog #### 0.1 Initial private build for OSHA establishment search, inspection detail enrichment, penalty totals, and violation item extraction. ### Support Open an issue on Apify if you need additional OSHA fields or a different enforcement-data workflow. # Actor input Schema ## `establishment` (type: `string`): Business, employer, or establishment keyword to search in OSHA IMIS records. ## `state` (type: `string`): Two-letter state code, or all for nationwide OSHA records. ## `startDate` (type: `string`): Earliest inspection open date. Use YYYY-MM-DD. ## `endDate` (type: `string`): Latest inspection open date. Use YYYY-MM-DD. ## `caseStatus` (type: `string`): Filter OSHA cases by open/closed status. ## `violationsExist` (type: `string`): Return inspections with violations, without violations, or both. ## `maxItems` (type: `integer`): Maximum OSHA inspection records to save. ## `includeViolationDetails` (type: `boolean`): Fetch each inspection detail page to add address, penalties, case status, and violation item details. ## `requestDelayMillis` (type: `integer`): Polite delay between OSHA page requests. Increase for large historical crawls. ## `startUrls` (type: `array`): Optional OSHA establishment.search URLs. When supplied, these override the search fields above. ## Actor input object example ```json { "establishment": "amazon", "state": "CA", "startDate": "2024-01-01", "endDate": "2024-12-31", "caseStatus": "all", "violationsExist": "both", "maxItems": 20, "includeViolationDetails": true, "requestDelayMillis": 250, "startUrls": [] } ``` # Actor output Schema ## `overview` (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 = { "establishment": "amazon", "state": "CA", "startDate": "2024-01-01", "endDate": "2024-12-31", "caseStatus": "all", "violationsExist": "both", "maxItems": 20, "includeViolationDetails": true, "requestDelayMillis": 250, "startUrls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/osha-inspections-violations-scraper").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 = { "establishment": "amazon", "state": "CA", "startDate": "2024-01-01", "endDate": "2024-12-31", "caseStatus": "all", "violationsExist": "both", "maxItems": 20, "includeViolationDetails": True, "requestDelayMillis": 250, "startUrls": [], } # Run the Actor and wait for it to finish run = client.actor("automation-lab/osha-inspections-violations-scraper").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 '{ "establishment": "amazon", "state": "CA", "startDate": "2024-01-01", "endDate": "2024-12-31", "caseStatus": "all", "violationsExist": "both", "maxItems": 20, "includeViolationDetails": true, "requestDelayMillis": 250, "startUrls": [] }' | apify call automation-lab/osha-inspections-violations-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/osha-inspections-violations-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OSHA Inspections and Violations Scraper", "description": "Search OSHA IMIS inspection records by company, state, date range, case status, and violations. Export inspection details, penalties, and citations.", "version": "0.1", "x-build-id": "zQ3q9KjAd90xfbLOk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~osha-inspections-violations-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-osha-inspections-violations-scraper", "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/automation-lab~osha-inspections-violations-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-osha-inspections-violations-scraper", "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/automation-lab~osha-inspections-violations-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-osha-inspections-violations-scraper", "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": [ "establishment" ], "properties": { "establishment": { "title": "Company or establishment name", "type": "string", "description": "Business, employer, or establishment keyword to search in OSHA IMIS records." }, "state": { "title": "State", "type": "string", "description": "Two-letter state code, or all for nationwide OSHA records.", "default": "all" }, "startDate": { "title": "Start date", "type": "string", "description": "Earliest inspection open date. Use YYYY-MM-DD.", "default": "2024-01-01" }, "endDate": { "title": "End date", "type": "string", "description": "Latest inspection open date. Use YYYY-MM-DD.", "default": "2024-12-31" }, "caseStatus": { "title": "Case status", "enum": [ "all", "open", "closed" ], "type": "string", "description": "Filter OSHA cases by open/closed status.", "default": "all" }, "violationsExist": { "title": "Violation filter", "enum": [ "both", "yes", "no" ], "type": "string", "description": "Return inspections with violations, without violations, or both.", "default": "both" }, "maxItems": { "title": "Maximum inspections", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum OSHA inspection records to save.", "default": 20 }, "includeViolationDetails": { "title": "Expand inspection detail pages", "type": "boolean", "description": "Fetch each inspection detail page to add address, penalties, case status, and violation item details.", "default": true }, "requestDelayMillis": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Polite delay between OSHA page requests. Increase for large historical crawls.", "default": 250 }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional OSHA establishment.search URLs. When supplied, these override the search fields above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```