# California WARN Notices Scraper (`automation-lab/california-warn-notices-scraper`) Actor Extract official California EDD WARN layoff notices with companies, counties, affected employees, dates, industry, and source links. - **URL**: https://apify.com/automation-lab/california-warn-notices-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 ## California WARN Notices Scraper Extract structured California EDD WARN layoff notices from the official public WARN page and current XLSX report. Use it to monitor layoffs, closures, affected employee counts, counties, dates, company names, addresses, and source links without manually downloading spreadsheets from the Employment Development Department. ### What does California WARN Notices Scraper do? California WARN Notices Scraper turns the public California EDD Worker Adjustment and Retraining Notification data into clean Apify dataset rows. It discovers the current official WARN report from the EDD WARN landing page. It downloads the XLSX report. It parses the detailed WARN report sheets. It normalizes company, county, address, notice date, effective date, processed date, layoff or closure type, employee counts, industry, and source metadata. It generates a stable key for monitoring and deduplication. It keeps the original source file URL on every row for auditability. ### Who is it for? Recruiting teams can monitor companies that are reducing headcount and may have available candidates. Outplacement providers can identify employers and regions with newly affected workers. Sales teams can find organizations going through restructuring events. Workforce boards can track layoffs and closures by county. Economic development teams can monitor local labor-market changes. Journalists can watch official notices for new employment-impact stories. Risk and compliance teams can schedule checks and diff changes over time. ### Why use this actor? The EDD page is public, but the useful data is inside report files. Manual spreadsheet checks are repetitive. Column names and date formats need normalization before automation. Scheduled Apify runs can create a repeatable monitoring feed. Stable keys help you compare new runs against old runs. Source URLs make downstream audits easier. ### Data source The actor starts from the official California EDD WARN page: https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN The actor discovers XLSX WARN report links from that page. The actor also logs discovered PDF archive links when archive discovery is enabled. Structured extraction focuses on XLSX reports because they provide reliable tabular fields. ### Output data Each dataset item represents one WARN notice row. | Field | Description | | --- | --- | | companyName | Employer or company name from the WARN report | | county | California county or parish column value | | address | Reported workplace address | | city | Parsed city when available from the address | | state | Parsed state abbreviation, normally CA | | postalCode | Parsed ZIP code when available | | noticeDate | WARN notice date as YYYY-MM-DD when available | | processedDate | EDD processed date as YYYY-MM-DD when available | | effectiveDate | Layoff, closure, or relocation effective date | | layoffClosureType | Layoff, closure, relocation, permanent, temporary, or unknown text | | affectedEmployees | Number of employees affected | | relatedIndustry | Industry or NAICS sector label from the report | | naicsSector | Leading NAICS sector code when present | | sourceUrl | Source XLSX report URL | | sourceFileType | Source file type, currently xlsx | | sourceSheet | Workbook sheet parsed | | sourceRowNumber | Source row number in the workbook | | stableKey | SHA-1 key for diffing and deduplication | | scrapedAt | Run timestamp | ### How much does it cost to scrape California WARN notices? This actor uses pay-per-event pricing. There is a small start charge per run. There is a per-item charge for each WARN notice saved. Formula-derived BRONZE pricing is about $0.00003 per WARN notice, with lower per-item prices on higher Apify tiers. Use `maxItems` and filters to control run size. Small county or company filters cost less than full statewide exports. ### Input options `startUrls` accepts the EDD WARN page or direct report URLs. `reportUrls` accepts optional direct XLSX report URLs. `maxItems` caps the number of rows saved. `county` filters by county text. `companyQuery` filters by company name text. `minNoticeDate` keeps notices on or after a date. `maxNoticeDate` keeps notices on or before a date. `includeArchives` discovers and logs archive files from the EDD page. ### Example input ```json { "startUrls": [ { "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" } ], "maxItems": 100, "includeArchives": true } ```` ### County monitoring example ```json { "startUrls": [ { "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" } ], "county": "Los Angeles County", "maxItems": 250, "includeArchives": true } ``` ### Company monitoring example ```json { "startUrls": [ { "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" } ], "companyQuery": "manufacturing", "maxItems": 100 } ``` ### Date filtering example ```json { "startUrls": [ { "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" } ], "minNoticeDate": "2026-01-01", "maxItems": 500 } ``` ### How to run Open the actor on Apify. Keep the prefilled EDD WARN URL. Choose a maximum item count. Optionally add county, company, or date filters. Start the run. Download results as JSON, CSV, Excel, XML, or via API. ### Scheduling tips Schedule daily or weekly runs for monitoring. Store previous datasets for comparison. Use `stableKey` to detect new rows. Use `noticeDate` and `processedDate` to sort changes. Use county filters for local workflows. Use company filters for account monitoring. ### Integrations Send new WARN notices to a CRM. Create Slack alerts when new notices appear in a county. Feed affected employee counts into a dashboard. Join company names with enrichment APIs. Trigger outreach workflows for outplacement services. Track county-level totals in a data warehouse. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/california-warn-notices-scraper').call({ startUrls: [{ url: 'https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN' }], maxItems: 100, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('MY-APIFY-TOKEN') run = client.actor('automation-lab/california-warn-notices-scraper').call(run_input={ 'startUrls': [{'url': 'https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN'}], 'maxItems': 100, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items[0]) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~california-warn-notices-scraper/runs?token=MY-APIFY-TOKEN' \ -H 'Content-Type: application/json' \ -d '{"startUrls":[{"url":"https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN"}],"maxItems":100}' ``` ### MCP for Claude Code Use Apify MCP tools to run this actor from Claude Code. MCP URL: https://mcp.apify.com/?tools=automation-lab/california-warn-notices-scraper Add the server with Claude Code: ```bash claude mcp add apify-california-warn "https://mcp.apify.com/?tools=automation-lab/california-warn-notices-scraper" ``` Equivalent MCP JSON config: ```json { "mcpServers": { "apify-california-warn": { "url": "https://mcp.apify.com/?tools=automation-lab/california-warn-notices-scraper" } } } ``` Example prompt: "Run the California WARN Notices Scraper for Los Angeles County and summarize the top employers by affected employees." ### MCP for Claude Desktop Add the Apify MCP server to Claude Desktop. Use the tool-filtered URL above. Example Claude Desktop MCP configuration: ```json { "mcpServers": { "apify-california-warn": { "url": "https://mcp.apify.com/?tools=automation-lab/california-warn-notices-scraper" } } } ``` Ask for a county-level WARN monitoring report. Export the dataset URL when you need the raw rows. ### Data quality notes Dates come from the official report and are normalized when possible. Some address strings may not contain a parseable ZIP code. Industry labels are preserved exactly from the report. The `naicsSector` field is extracted from the leading sector code when present. Every row includes the source workbook URL. ### Archive behavior The EDD page links historical PDF archives. The actor discovers those archive URLs when `includeArchives` is enabled. Current structured extraction is optimized for XLSX reports. PDF archive URLs are logged for audit context. Use direct XLSX report URLs in `reportUrls` when EDD publishes additional structured files. ### Troubleshooting If you get zero items, check whether your county, company, or date filter is too narrow. If a date filter seems wrong, confirm that the source row has a valid notice date. If EDD changes the page, provide the direct XLSX report URL in `reportUrls`. If you need more rows, increase `maxItems`. ### Legality This actor extracts publicly available California EDD WARN information. Respect Apify terms and your own compliance obligations. Do not use the data for unlawful discrimination, harassment, or prohibited employment decisions. Keep personal data handling policies aligned with applicable laws. ### Related scrapers Try other automation-lab actors for company enrichment, job-market monitoring, government data extraction, and lead workflows. Useful adjacent categories include business intelligence, public records, jobs, and government data. ### FAQ #### Does this actor require a login? No. It uses public California EDD pages and report files. #### Does it use a browser? No. It uses lightweight HTTP requests and XLSX parsing. #### Can I monitor one county? Yes. Use the `county` filter. #### Can I monitor one company? Yes. Use `companyQuery`. #### Can I diff new notices? Yes. Use `stableKey` to compare current and previous datasets. #### Can I export to Excel? Yes. Apify datasets can be downloaded as Excel, CSV, JSON, XML, RSS, and HTML. #### What happens if EDD moves the report link? Use the EDD landing page as `startUrls`; the actor discovers current XLSX links. If needed, provide a direct XLSX URL in `reportUrls`. #### Why are archive PDFs not parsed into structured rows? The current production extraction focuses on structured XLSX data for reliability. Archive PDF links are still discovered and logged for source awareness. # Actor input Schema ## `startUrls` (type: `array`): California EDD WARN landing page or direct XLSX report URLs. Leave the prefilled EDD page to discover the current official report automatically. ## `reportUrls` (type: `array`): Optional direct WARN XLSX files to parse in addition to links discovered from start URLs. ## `maxItems` (type: `integer`): Maximum WARN notice records to save. The default is enough for a useful sample while keeping first runs inexpensive. ## `county` (type: `string`): Optional county substring, for example Los Angeles County or Alameda. ## `companyQuery` (type: `string`): Optional case-insensitive company name substring. ## `minNoticeDate` (type: `string`): Optional earliest notice date in YYYY-MM-DD format. ## `maxNoticeDate` (type: `string`): Optional latest notice date in YYYY-MM-DD format. ## `includeArchives` (type: `boolean`): When enabled, the actor logs historical PDF archive URLs discovered on the EDD page for audit context while extracting structured rows from XLSX reports. ## Actor input object example ```json { "startUrls": [ { "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" } ], "reportUrls": [], "maxItems": 20, "includeArchives": true } ``` # 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 = { "startUrls": [ { "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" } ], "reportUrls": [], "maxItems": 20, "includeArchives": true }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/california-warn-notices-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 = { "startUrls": [{ "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" }], "reportUrls": [], "maxItems": 20, "includeArchives": True, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/california-warn-notices-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 '{ "startUrls": [ { "url": "https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN" } ], "reportUrls": [], "maxItems": 20, "includeArchives": true }' | apify call automation-lab/california-warn-notices-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/california-warn-notices-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "California WARN Notices Scraper", "description": "Extract official California EDD WARN layoff notices with companies, counties, affected employees, dates, industry, and source links.", "version": "0.1", "x-build-id": "RQZd6biAoxEOsYpVl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~california-warn-notices-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-california-warn-notices-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~california-warn-notices-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-california-warn-notices-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~california-warn-notices-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-california-warn-notices-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", "properties": { "startUrls": { "title": "EDD WARN page or report URLs", "type": "array", "description": "California EDD WARN landing page or direct XLSX report URLs. Leave the prefilled EDD page to discover the current official report automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "reportUrls": { "title": "Direct XLSX report URLs", "type": "array", "description": "Optional direct WARN XLSX files to parse in addition to links discovered from start URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum WARN notices", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum WARN notice records to save. The default is enough for a useful sample while keeping first runs inexpensive.", "default": 20 }, "county": { "title": "County filter", "type": "string", "description": "Optional county substring, for example Los Angeles County or Alameda." }, "companyQuery": { "title": "Company name contains", "type": "string", "description": "Optional case-insensitive company name substring." }, "minNoticeDate": { "title": "Earliest notice date", "type": "string", "description": "Optional earliest notice date in YYYY-MM-DD format." }, "maxNoticeDate": { "title": "Latest notice date", "type": "string", "description": "Optional latest notice date in YYYY-MM-DD format." }, "includeArchives": { "title": "Discover archive files", "type": "boolean", "description": "When enabled, the actor logs historical PDF archive URLs discovered on the EDD page for audit context while extracting structured rows from XLSX reports.", "default": true } } }, "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 } } } } } } } } } } ```