{ "openapi": "3.0.1", "info": { "title": "OSHA Enforcement violations & inspections", "description": "US employers with OSHA citations from DOL's bulk Inspection + Violation API (federal + all state plans, daily). Ranked hottest-first by penalty and willful/repeat severity. Company, address, NAICS, decoded standards, penalties, contest status — for OSHA defense attorneys & safety consultants.", "version": "1.0", "x-build-id": "1xPnM5y7UWDtDQlHo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ayoub_highlighter~osha-enforcement-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ayoub_highlighter-osha-enforcement-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/ayoub_highlighter~osha-enforcement-leads/runs": { "post": { "operationId": "runs-sync-ayoub_highlighter-osha-enforcement-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/ayoub_highlighter~osha-enforcement-leads/run-sync": { "post": { "operationId": "run-sync-ayoub_highlighter-osha-enforcement-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", "required": [ "dolApiKey" ], "properties": { "dolApiKey": { "title": "DOL API key (required)", "type": "string", "description": "Your free DOL Open Data API key from dataportal.dol.gov. Required — the OSHA data is gated behind it." }, "openedOnOrAfter": { "title": "Inspection opened on or after (exact date)", "type": "string", "description": "Type or pick an exact date. Pulls inspections opened on/after this day. Leave blank to default to the last 365 days. Citations post ~30–60 days after the inspection opens." }, "violationType": { "title": "Violation type", "enum": [ "", "W", "R", "WR", "S" ], "type": "string", "description": "Filter by the worst violation type on the case.", "default": "" }, "states": { "title": "States", "type": "array", "description": "Leave blank for all states + territories. Pick to limit to a client's territory.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "GU", "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", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "VI", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Guam", "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", "Puerto Rico", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "U.S. Virgin Islands", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] }, "default": [] }, "naicsSector": { "title": "Industry sector", "enum": [ "", "construction", "manufacturing", "transport_warehouse", "healthcare", "agriculture", "wholesale", "retail", "waste", "food_service", "utilities" ], "type": "string", "description": "Leave blank for all industries.", "default": "" }, "minPenalty": { "title": "Minimum total penalty", "minimum": 0, "type": "integer", "description": "Optional. Type the exact dollar amount. Only cases with at least this much in current penalties. Leave blank for any amount." }, "caseStatus": { "title": "Case status", "enum": [ "", "open", "closed" ], "type": "string", "description": "Open = still in the legal window (defense attorneys). Closed = settled/adjudicated (safety consultants).", "default": "" }, "leadType": { "title": "Lead type", "enum": [ "", "OPEN_HAZARD", "CONTEST_OPPORTUNITY", "SAFETY_REBUILD", "MULTIPLE" ], "type": "string", "description": "Filter to a specific lead category.", "default": "" }, "minEmployees": { "title": "Minimum employees at site", "minimum": 0, "type": "integer", "description": "Optional. Type the minimum number of employees at the cited site. Larger employers are far more likely to have a website (higher enrichment rate). Leave blank for no minimum. Rows with no reported employee count are dropped when a minimum is set." }, "companiesOnly": { "title": "Companies only (enrichment-ready names)", "type": "boolean", "description": "On (default): drop sole-proprietor person names and junk, so every row is a real, enrichable company. Off: include one-person businesses listed under the owner's name.", "default": true }, "maxRecords": { "title": "Max records", "minimum": 1, "type": "integer", "description": "Optional. Type any number to cap results (hottest-first). Leave blank for all matching." } } }, "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 } } } } } } } } } }