{
  "openapi": "3.0.1",
  "info": {
    "title": "WARN layoff notices scraper - CA, TX, NY, PA + 16 more states",
    "description": "WARN layoff and closure notices from 20 US states' own published lists (CA IL NY AK AL ID MA MT NC ND NE NJ OR PA SD TN TX UT VA WA), normalised to one schema: employer, city, county, employees, notice date, effective date, notice type, source file. $10 per 1,000 rows, no run fee.",
    "version": "0.3",
    "x-build-id": "W5vC08gPM3rB4nJRi"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/retrainmap~warn-notices/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-retrainmap-warn-notices",
        "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/retrainmap~warn-notices/runs": {
      "post": {
        "operationId": "runs-sync-retrainmap-warn-notices",
        "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/retrainmap~warn-notices/run-sync": {
      "post": {
        "operationId": "run-sync-retrainmap-warn-notices",
        "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": {
          "states": {
            "title": "States",
            "uniqueItems": true,
            "type": "array",
            "description": "State WARN lists to read, in this order (default CA, IL, NY). CA = the EDD current-period WARN workbook; IL = the newest monthly DCEO workbooks (see il_months_back); NY = the NYS DOL WARN dashboard export. The other 17 are each state's own published WARN page, CSV or workbook; a state that cannot be read is listed in RUN_SUMMARY.failed_states and costs nothing. PA publishes no notice date (see the README): its rows carry the filing month in source_period and notice_date is null. NC covers the current calendar year only, because the state publishes earlier years as PDF reports rather than pages. MT publishes no city and no closure/layoff type, and prints the year each notice was filed under in source_period; it does publish the industry of every employer. ID and ND each publish their whole WARN history as one PDF, linked from the page rather than named, and neither publishes a county or a closure/layoff type; ID does publish a street address and ZIP for every site.",
            "items": {
              "type": "string",
              "enum": [
                "CA",
                "IL",
                "NY",
                "AK",
                "AL",
                "MA",
                "MT",
                "NC",
                "NE",
                "NJ",
                "OR",
                "PA",
                "SD",
                "TN",
                "TX",
                "UT",
                "VA",
                "WA",
                "ID",
                "ND"
              ],
              "enumTitles": [
                "California (EDD)",
                "Illinois (DCEO / Illinois workNet)",
                "New York (NYS DOL dashboard)",
                "Alaska (jobs.alaska.gov)",
                "Alabama (workforce.alabama.gov)",
                "Massachusetts (mass.gov weekly CSVs)",
                "Montana (wsd.dli.mt.gov workbook)",
                "North Carolina (commerce.nc.gov, current year)",
                "Nebraska (dol.nebraska.gov)",
                "New Jersey (nj.gov WARN archive workbook)",
                "Oregon (ccwd.hecc.oregon.gov)",
                "Pennsylvania (pa.gov Department of Labor and Industry)",
                "South Dakota (dlr.sd.gov)",
                "Tennessee (tn.gov)",
                "Texas (twc.texas.gov yearly workbooks)",
                "Utah (jobs.utah.gov)",
                "Virginia (virginiaworks.gov CSV)",
                "Washington (fortress.wa.gov WARN search)",
                "Idaho (labor.idaho.gov cumulative PDF)",
                "North Dakota (jobsnd.com cumulative PDF)"
              ]
            },
            "default": [
              "CA",
              "IL",
              "NY"
            ]
          },
          "max_records": {
            "title": "Maximum records",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many rows in total (states are read in the order given).",
            "default": 5000
          },
          "il_months_back": {
            "title": "Illinois: monthly workbooks to read",
            "minimum": 1,
            "maximum": 12,
            "type": "integer",
            "description": "How many of the newest monthly Illinois WARN workbooks to read (1-12). Each is one request.",
            "default": 2
          },
          "request_interval_ms": {
            "title": "Minimum interval between requests (ms)",
            "minimum": 500,
            "maximum": 10000,
            "type": "integer",
            "description": "Politeness delay towards the state servers (floor 500 ms).",
            "default": 1000
          },
          "contact_email": {
            "title": "Contact e-mail (From: header)",
            "type": "string",
            "description": "Sent in the standard From: request header so a data owner can reach the operator.",
            "default": "info@steelyardclinical.com"
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}