APProjects commited on
Commit
bbbb3ab
Β·
verified Β·
1 Parent(s): 4ffdff4

Sync canonical offer/contact block (hf_cards_sync)

Browse files
Files changed (1) hide show
  1. README.md +95 -0
README.md CHANGED
@@ -132,3 +132,98 @@ same CC BY 4.0 licence.
132
 
133
  Source code: [github.com/APVentureEngine/warn-act-notices](https://github.com/APVentureEngine/warn-act-notices).
134
  Underlying scrapers include Apache-2.0 code from `biglocalnews/warn-scraper`.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
132
 
133
  Source code: [github.com/APVentureEngine/warn-act-notices](https://github.com/APVentureEngine/warn-act-notices).
134
  Underlying scrapers include Apache-2.0 code from `biglocalnews/warn-scraper`.
135
+
136
+ <!-- warn-feed:offer:start -->
137
+ ## A layoff record you can audit, not just download
138
+
139
+ This dataset is one cut of a single daily rebuild: **61,428 US WARN Act
140
+ layoff notices from 48 state agencies, 1988 to today**, one schema, no
141
+ login, no delay, CC BY 4.0. Snapshot as of **2026-09-24**; the files above are
142
+ rebuilt every day, so the live count is the truth.
143
+
144
+ Several projects publish a current WARN scrape and two of them carry more rows
145
+ than we do. None of them publish what the records **used to say**:
146
+
147
+ - **2,472 observed changes to already-published notices, logged daily since 2026-08-31.**
148
+ `data/revisions.csv` records every field that differed between two consecutive
149
+ daily builds β€” employee counts, effective dates, notice types, company names β€”
150
+ with the old value, the new value and the date we saw it. We publish the
151
+ observation and not the cause: a change is equally explained by the agency
152
+ amending the notice or by our own parser improving, and we do not guess which
153
+ (see `data/revisions.README.txt`). A scrape that starts tomorrow cannot backfill
154
+ any of it; it only exists if someone was watching.
155
+ - **6,799 notices whose state agency page no longer lists them.** Agencies
156
+ take notices down. We keep them, flagged as archive-only, so a count you ran
157
+ last year still reconciles.
158
+ - **Point-in-time employer identity.** The ticker crosswalk resolves a filer to
159
+ the company as it existed at the time of the notice β€” Kmart, Sears Holdings,
160
+ Symantec β€” not to whatever is on today's ticker file.
161
+
162
+ If you have to defend a number to an editor, a referee or a compliance reviewer,
163
+ that provenance layer is the part you cannot rebuild yourself.
164
+ [How to cite this dataset β†’](https://github.com/APVentureEngine/warn-act-notices/blob/main/CITATION.cff)
165
+
166
+ **Look something up right now β€” free, no signup, nothing to install.**
167
+ [Check any employer or state against the last 180 days
168
+ β†’](https://approjects-warn-act-notices.static.hf.space/watch-now.html) It runs in your browser against these same files.
169
+
170
+ **Building something with it?** The same files are a free HTTP API β€” JSON and
171
+ CSV, no key, no signup, `access-control-allow-origin: *` so `fetch()` works from
172
+ a browser: [endpoints, schema and curl examples β†’](https://approjects-warn-act-notices.static.hf.space/api.html)
173
+
174
+ **Prefer a spreadsheet?** One formula puts the last 90 days, the last 12 months
175
+ or any single state into Google Sheets as a live range that refreshes itself β€”
176
+ no signup, no add-on: [the formulas, one per state β†’](https://approjects-warn-act-notices.static.hf.space/sheets.html)
177
+ `=IMPORTDATA("https://cdn.jsdelivr.net/gh/APVentureEngine/warn-act-notices@main/data/sheets/us-last-90-days.csv")`
178
+
179
+ **Backtesting, or citing a figure you published last month?** Today's file has
180
+ look-ahead and survivorship bias baked in: notices get amended after the fact and
181
+ some rows are later deleted. The same table as it stood on any past day since
182
+ **2026-08-30** β€” one immutable vintage per day, 24 so far, plus a first-appearance
183
+ index giving the first and last day every notice id was in the file β€” is the
184
+ [point-in-time snapshot archive](https://huggingface.co/datasets/APProjects/us-warn-act-layoffs-point-in-time-snapshots). Nobody can backfill it.
185
+
186
+ **Need one industry only?** The same filings, cut by an auditable employer-name
187
+ rule (each row keeps the rule that fired): [tech companies](https://huggingface.co/datasets/APProjects/us-tech-company-layoffs-warn-act-notices-daily)
188
+ Β· [hospitals & healthcare](https://huggingface.co/datasets/APProjects/us-hospital-healthcare-layoffs-warn-act-notices-daily)
189
+ Β· [retail store closings](https://huggingface.co/datasets/APProjects/us-retail-store-closings-layoffs-warn-act-notices-daily)
190
+ Β· [restaurants & hotels](https://huggingface.co/datasets/APProjects/us-restaurant-hotel-closings-layoffs-warn-act-notices-daily)
191
+ Β· [factory & plant closings](https://huggingface.co/datasets/APProjects/us-factory-plant-closings-manufacturing-layoffs-warn-act-notices-daily)
192
+ Β· [banks, insurance & finance](https://huggingface.co/datasets/APProjects/us-bank-insurance-finance-layoffs-warn-act-notices-daily)
193
+ Β· [warehouses, trucking & logistics](https://huggingface.co/datasets/APProjects/us-warehouse-trucking-logistics-layoffs-warn-act-notices-daily)
194
+ Β· [all 20 sectors](https://huggingface.co/datasets/APProjects/us-layoffs-by-industry-sector-warn-act).
195
+
196
+ **Or have it watch a list for you.** Coming back to look is the part a CSV cannot
197
+ do. **WARN Watch β€” $49 for a year**, one payment, nothing auto-renews, 14-day
198
+ refund, no login: up to 500 employer names plus whole states, matched on every
199
+ daily refresh, delivered to a private alert page + calendar (.ics) + RSS +
200
+ an optional Slack / Discord / Teams webhook. Every alert carries that employer's
201
+ whole filing history from the archive, which a keyword rule on an RSS feed cannot
202
+ see. There is no built-in email β€” we do not claim one.
203
+
204
+ - [See a real alert page before paying](https://approjects-warn-act-notices.static.hf.space/watch-sample.html) Β· [what you get](https://approjects-warn-act-notices.static.hf.space/watch.html)
205
+ - [Try it free for 30 days, no card](https://approj.gumroad.com/l/warn-free-watch) Β· [Buy β€” $49/year](https://approj.gumroad.com/l/warn-watch)
206
+
207
+ **Not deciding today?** [Join the update list β†’](https://approj.gumroad.com/subscribe) β€” one email when a
208
+ new dataset or tier is published; nothing promotional. A state added or a column
209
+ renamed ships in the [daily release](https://github.com/APVentureEngine/warn-act-notices/releases) instead, no address
210
+ needed. The list is
211
+ shared across APProjects datasets, holds an email address only, is run by
212
+ Gumroad, and any message unsubscribes you. Rather give no address at all?
213
+ [Watch the repo's releases](https://github.com/APVentureEngine/warn-act-notices/subscription) β€” GitHub notifies you on
214
+ every daily republish, and a new state or changed field is in those notes the
215
+ day it lands.
216
+
217
+ **Reaching a human.** WARN Feed is published by APProjects, an automated data
218
+ publisher β€” that is stated plainly rather than dressed up. Corrections, coverage
219
+ gaps, schema questions and refund requests all go here and are read:
220
+ [open an issue](https://github.com/APVentureEngine/warn-act-notices/issues/new/choose). Payments are handled by Gumroad as merchant of
221
+ record, so an invoice can carry your company name.
222
+
223
+ [Source, scrapers and methodology](https://github.com/APVentureEngine/warn-act-notices) Β· [the 48-state site](https://approjects-warn-act-notices.static.hf.space/)
224
+ <!-- warn-feed:offer:end -->
225
+
226
+ <!-- warn-feed:px:start -->
227
+ <img src="https://cdn.jsdelivr.net/gh/APVentureEngine/warn-act-notices@main/assets/px/hf/space-warn-act-notices.png" width="1" height="1" alt="">
228
+ <sub>Card views are counted anonymously: one 1Γ—1 image on a public CDN, no cookies, no script, no personal data. The count is public: <a href="https://data.jsdelivr.com/v1/stats/packages/gh/APVentureEngine/warn-act-notices@main/files?period=month">jsDelivr stats</a>.</sub>
229
+ <!-- warn-feed:px:end -->