WARN Firehose — Labor Market Intelligence

authenticate

Authenticate with your WARN Firehose API key. Returns your tier and access level. Args: api_key: Your WARN Firehose API key (starts with wf_)

get_pricing

Return WARN Firehose pricing tiers, included tools, and signup URLs. Use this when the user asks about pricing, hits a rate limit, or wants to upgrade. Returns tier prices, daily call limits, included datasets, and direct signup links so the user can act immediately.

No parameters.

search_layoffs

Search WARN Act layoff notices by company name, city, or keyword. Args: query: Search term (company name, city, etc.) state: Optional 2-letter state code to filter (e.g. CA, TX, NY) limit: Max results to return (default 20, max 100) api_key: Optional API key for higher rate limits

get_state_summary

Get a summary of WARN Act layoff data for a specific US state. Args: state: Two-letter state code (e.g. CA, TX, NY, FL) api_key: Optional API key for higher rate limits

get_recent_layoffs

Get the most recent WARN Act layoff notices. Args: days: Look back this many days (default 30) state: Optional state filter (2-letter code) limit: Max results (default 25, max 100) api_key: Optional API key for higher rate limits

get_stats

Get overall statistics about the WARN Firehose database.

get_company_layoffs

Get all WARN Act layoff notices for a specific company. Args: company: Company name to search for (partial match supported) api_key: Optional API key for higher rate limits

get_talent_pipeline

Find available talent from recent layoffs, cross-referenced with LCA visa roles. Shows what occupations/skills each laid-off company was hiring for. Useful for recruiters targeting skilled workers from recently laid-off companies. Requires Starter tier or higher. Get your API key at warnfirehose.com/account Args: state: Optional 2-letter state code days: Look back this many days (default 90) limit: Max results (default 15, max 50) api_key: Your WARN Firehose API key (Starter tier required)

get_risk_signal

Get companies ranked by composite distress signal across all datasets. Combines WARN layoff volume/recency, SEC restructuring filings, bankruptcy filings, and H-1B denial rates into a single risk score. Levels: Critical (7+), Elevated (4-6), Moderate (2-3), Low (1). Requires Starter tier or higher. Get your API key at warnfirehose.com/account Args: state: Optional 2-letter state code to filter min_score: Minimum risk score (default 3) limit: Max results (default 15, max 50) api_key: Your WARN Firehose API key (Starter tier required)

get_market_pulse

Get a single-call market snapshot across all 6 datasets. Returns: WARN stats (30d trend), top industries, at-risk companies, LCA/H-1B counts, DOL claims, SEC filings, bankruptcies, JOLTS snapshot. Args: api_key: Optional API key for higher rate limits

get_state_intelligence

Get a unified state profile combining all 6 datasets for a US state. Returns WARN notices, LCA petitions, H-1B approvals/denials, DOL claims, bankruptcy matches, JOLTS data, and a composite distress score. Requires Pro tier or higher. Get your API key at warnfirehose.com/account Args: state_code: Two-letter state abbreviation (e.g. CA, TX, NY) api_key: Your WARN Firehose API key (Pro tier required)

export_records

Export WARN records in bulk. Requires Pro tier or higher. Returns up to 500 records with full field details. For CSV/Parquet downloads, use the REST API at /api/export/. Get your API key at warnfirehose.com/account Args: api_key: Your WARN Firehose API key (Pro tier required) state: Optional 2-letter state code filter company: Optional company name filter (partial match) days: Look back this many days (default 90, max 730) limit: Max records to return (default 100, max 500)