WARN notices scraper - California, Illinois, New York layoffs

Returns: one row per current WARN layoff/closure notice from the California EDD report, the Illinois DCEO monthly workbooks and the New York State DOL WARN dashboard — employer, city, county, employees, notice date, effective date, notice type, source file and its server date. Input: { "states": ["CA", "IL", "NY"], "il_months_back": 2, "max_records": 5000 } — all optional; empty {} reads all three states. Price: $10.00 per 1,000 rows ($0.01 per notice row). No run fee. Pay per event; no subscription.

Current Worker Adjustment and Retraining Notification (WARN) layoff and closure notices from three state agencies, normalised to one row schema: state, employer, city, county, employees, notice_date, effective_date, notice_type, source_url, file_last_modified — plus the extra columns each state publishes (address, ZIP, reason, industry, NAICS, layoff schedule). One row per notice or per affected site, exactly as the agency lists it.

Nothing here decides anyone's eligibility. Whether a worker is covered by WARN, owed notice pay, or eligible for unemployment insurance or retraining aid is decided locally by the state agency, the local workforce board and, for WARN itself, the courts. The rows are the agencies' published lists — the agencies say they do not capture all layoff activity.

Sources, cadence and status

State	File read on every run	Cadence	Status
CA	California EDD — Detailed WARN Report sheet of https://edd.ca.gov/siteassets/files/jobs_and_training/warn/warn_report1.xlsx (page: https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN/)	The workbook says it is "updated every Tuesday and Thursday"; it covers the current reporting period (e.g. "07/01/26 to 08/31/2026"), which the row field source_period repeats	Public record of a state agency, published for public use
IL	Illinois DCEO monthly WARN workbooks linked from https://www.illinoisworknet.com/LayoffRecovery/Pages/ArchivedWARNReports.aspx (page: https://dceo.illinois.gov/workforcedevelopment/warn.html). The newest il_months_back workbooks are read (xlsx from March 2020; older months are PDFs and are not read)	Monthly	Public record of a state agency, published for public use
NY	New York State DOL WARN Dashboard data export — https://public.tableau.com/views/WorkerAdjustmentRetrainingNotificationWARN/WARN.csv (page: https://dol.ny.gov/warn-dashboard; NYS DOL: "As of 4/1/2025, WARN notices will no longer be posted to the database and can be found in the new WARN Dashboard")	Continuous (dashboard); the export covers the current year's notices	Public record of a state agency, published for public use

Copyright: the federal WARN Act materials are works of the United States Government and not subject to copyright (17 U.S.C. §105). The state files are public records released by state agencies for public use; the rows reproduce the facts they publish (employer, dates, counts), and facts are not copyrightable. Please cite the agency named in source_page.

Politeness: the plain Python-urllib User-Agent, the operator's contact address in the standard From: header, at most one request per second (default). A full run is five requests (CA file; IL archive page + two workbooks; NY export).

Layout guard

Each file is checked against the exact column layout measured on 2026-09-03 (the nine CA columns, the twenty IL columns, the twelve NY columns). If a state changes its layout, the run fails with the expected and the found header — it never guesses a mapping. The failure text tells the maintainer which parser to update.

Input

Field	Type	Meaning
states	array of CA / IL / NY	Default all three, read in the order given
max_records	integer	Default 5000
il_months_back	integer 1–12	Default 2: newest monthly Illinois workbooks to read
request_interval_ms	integer	Default 1000 (floor 500)
contact_email	string	Sent in the From: header

Output (dataset row)

Common: state, employer, city, county, zip, address, employees, notice_date, effective_date (ISO date when the file gives a date; otherwise null with the verbatim text in effective_date_text, e.g. Illinois' "10/25/2026 or w/in 14 days after"), notice_type (Closure Permanent, Layoff Temporary, ...; the raw wording in notice_type_raw), reason, industry, source_url, source_page, source_period, file_last_modified (the server's Last-Modified header — California sends one, Illinois and the NY export do not, then null), fetched_at, notice_id (stable hash of state, employer, dates, address and count — use it to de-duplicate across runs).

notice_kind is initial for every CA and NY row and for the month's notices in Illinois; Illinois workbooks also carry a second table, supplemental notices (amendments to earlier notices: extra workers, changed dates), which come out as rows with notice_kind: "supplemental", notice_type: "Supplemental", the agency's wording in supplemental_info, the original filing in initial_notice_date, and employees = the additional workers affected. Both Illinois tables have their own exact header guard, and the parser reconciles the month's rows with the sheet's own "Total Layoff Events" / "Total Impacted" figures (recorded in RUN_SUMMARY).

Per state: CA processed_or_posted_date; IL dba, ending_layoff_date, layoff_schedule, naics, union, local_workforce_area, region, ceja_related, supplemental_info, initial_notice_date; NY processed_or_posted_date, site_index.

A run summary (per-state counts, workbook labels, request count) is stored as RUN_SUMMARY in the run's key-value store.

Pricing (pay per event)

Event	Price
warn-record — per row written	$0.01

A typical full run (about 190 CA rows, 100–150 IL rows for two months, 190 NY rows) costs about $5. Rows stop when your run's maximum charge is reached; the run summary says so.

Operator

Steelyard Ventures LLC (RetrainMap) — info@steelyardclinical.com. The Actor writes only to its own dataset and key-value store; it stores no credentials and sends nothing else.