Metadata-Version: 2.4
Name: h1b-tracker
Version: 0.1.0
Summary: Analyze DOL H1B LCA disclosure data to rank employers by filing volume, salary, and sponsorship reliability
License: MIT
Project-URL: Homepage, https://github.com/Jaypatel1511/h1b-tracker
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: pandas>=1.4.0
Requires-Dist: numpy>=1.21.0
Requires-Dist: requests>=2.27.0
Requires-Dist: openpyxl>=3.0.0

# h1b-tracker 🔍

**Analyze DOL H1B LCA disclosure data to rank employers by filing volume,
salary, and sponsorship reliability.**

Filter by job category, state, and city. Built for international candidates
targeting H1B sponsoring employers in finance and beyond.

---

## Why h1b-tracker?

Every international job seeker manually checks h1bgrader.com or myvisajobs.com
one employer at a time. h1b-tracker automates that — download the full DOL
dataset once and run ranked queries across thousands of employers instantly.

---

## Installation

    pip install h1b-tracker

---

## Quickstart

    from h1btracker import load_from_url, filter, employer, report

    # Download and load FY2024 DOL LCA data (~100MB, cached locally)
    df = load_from_url("FY2024")

    # Top finance H1B sponsors in Illinois
    report.finance_sponsors(df, state="IL", top_n=20)

    # Filter to Chicago finance jobs above $120k
    chicago = filter.by_state(df, "IL")
    chicago = filter.by_city(chicago, "CHICAGO")
    chicago = filter.finance_jobs(chicago, method="keywords")
    chicago = filter.by_salary(chicago, min_salary=120_000)

    # Rank employers
    ranked = employer.rank(chicago, top_n=25)
    print(ranked)

    # Detailed profile for a specific employer
    report.employer_profile(df, "NORTHERN TRUST")

---

## Modules

- loader   - Download and load DOL LCA Excel files with local caching
- filter   - Filter by state, city, employer, salary, job category, visa class
- employer - Rank employers by LCA volume, approval rate, and median salary
- report   - Generate formatted summary reports for locations and employers

---

## Data Source

Data comes directly from the US Department of Labor OFLC disclosure files,
updated quarterly. Each record represents a Labor Condition Application filed
before an H-1B petition.

    FY2025: October 2024 - September 2025
    FY2024: October 2023 - September 2024
    FY2023: October 2022 - September 2023

---

## Example Output

    Top Finance H1B Sponsors — IL
    =====================================================================
      employer_name         total_lcas  approval_rate  median_salary
      JP MORGAN CHASE              842           97.2         145000
      NORTHERN TRUST               312           98.1         128000
      MORNINGSTAR                  187           96.4         118000
      WILLIAM BLAIR                 94           95.7         135000
      NUVEEN                        76           97.0         142000

---

## Running Tests

    PYTHONPATH=. pytest tests/ -v

22 tests across all modules.

---

## Who This Is For

- International candidates on H1B visas targeting reliable sponsors
- Finance professionals filtering employers by sponsorship history
- Researchers analyzing H1B labor market trends by industry and location

---

## License

MIT 2026 Jaypatel1511
