H-1B LCA Disclosure Data Scraper

Scrape US Department of Labor (DOL) H-1B / H-1B1 / E-3 Labor Condition Application (LCA) disclosure data — the official quarterly dataset every employer sponsoring an H-1B, H-1B1, or E-3 visa worker must file. Search by employer, job title, SOC occupation code, wage range, worksite state/city, visa class, and more, or look up exact case numbers. No auth or cookies required; a Residential proxy is required since dol.gov blocks datacenter egress IPs on these large downloads.

What this actor does

• Two modes: search (filter across the full disclosure file) and byCaseNumbers (exact lookup)
• Selectable fiscal year: scan the latest quarterly file (auto-discovered) or any closed fiscal year back to FY2020
• Rich filters: employer name, employer FEIN (exact), job title, SOC occupation title/code, NAICS code, case status, visa class, worksite state/city, employer (sponsor) state, wage range and pay unit, prevailing wage range/level, total worker positions range, full-time only, filed with an agent/attorney, attorney/law firm name, H-1B dependent employer, willful violator, received/decision date ranges
• Full case detail: employer, worksite, wage, attorney/agent, and preparer information per record
• Multi-worksite detail: the small share of cases that disclose more than one physical worksite get every location joined in automatically from DOL's separate LCA Worksites file
• Empty fields are omitted

Output per LCA disclosure

• caseNumber, caseStatus, visaClass
• receivedDate, decisionDate, originalCertDate, beginDate, endDate
• jobTitle, socCode, socTitle, fullTimePosition
• totalWorkerPositions, newEmploymentCount, continuedEmploymentCount, changePreviousEmploymentCount, newConcurrentEmploymentCount, changeEmployerCount, amendedPetitionCount
• employerName, tradeNameDba, employerAddress, employerCity, employerState, employerPostalCode, employerCountry, employerProvince, employerPhone, employerFein, naicsCode
• employerPocName, employerPocJobTitle, employerPocAddress, employerPocCity, employerPocState, employerPocPostalCode, employerPocCountry, employerPocProvince, employerPocPhone, employerPocEmail
• agentRepresentingEmployer, agentAttorneyName, agentAttorneyAddress, agentAttorneyCity, agentAttorneyState, agentAttorneyPostalCode, agentAttorneyCountry, agentAttorneyProvince, agentAttorneyPhone, agentAttorneyEmail, lawfirmName, lawfirmFein, attorneyBarState, attorneyBarCourt
• worksiteWorkers, secondaryEntity, secondaryEntityBusinessName, worksiteAddress, worksiteCity, worksiteCounty, worksiteState, worksitePostalCode
• wageRateFrom, wageRateTo, wageUnitOfPay, prevailingWage, pwUnitOfPay, pwTrackingNumber, pwWageLevel, pwOesYear, pwOtherSource, pwOtherYear, pwSurveyPublisher, pwSurveyName
• totalWorksiteLocations, agreeToLcStatement, h1bDependent, willfulViolator, supportH1b, statutoryBasis, appendixAAttached, publicDisclosure
• masterExemptionWorkerCount, masterExemptionDegrees (array of {institutionName, fieldOfStudy, dateOfDegree}) — advanced-degree exemption detail from DOL's Appendix A file, present only for the subset of H-1B-dependent-employer cases that claim the masters/advanced-degree exemption
• additionalWorksiteLocations (array of {worksiteWorkers, secondaryEntity, secondaryEntityBusinessName, worksiteAddress, worksiteCity, worksiteCounty, worksiteState, worksitePostalCode, wageRateFrom, wageRateTo, wageUnitOfPay, prevailingWage, pwUnitOfPay, pwWageLevel}) — every worksite location DOL's separate LCA Worksites file discloses for the case, joined in by case number automatically; present only for the minority of cases that report more than one worksite (a filing can disclose up to 10)
• preparerName, preparerBusinessName, preparerEmail
• sourceUrl — the DOL disclosure file this record came from
• recordType: "lcaDisclosure", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byCaseNumbers
fiscalYear	string	latest	latest (auto-discovered) / FY2025 / FY2024 / FY2023 / FY2022 / FY2021 / FY2020
caseNumbers	array	–	Exact case numbers to look up (mode=byCaseNumbers)
employerName	string	–	Substring match on employer legal name or trade name/DBA
jobTitle	string	–	Substring match on job title
socCode	string	–	Exact or prefix match on SOC code, e.g. 19-2031
caseStatus	string	any	Certified / Certified - Withdrawn / Denied / Withdrawn
visaClass	string	any	H-1B / H-1B1 Chile / H-1B1 Singapore / E-3 Australian
worksiteState	string	any	Two-letter US state/territory code
worksiteCity	string	–	Substring match on worksite city
naicsCode	string	–	Exact or prefix match on employer NAICS code
socTitle	string	–	Substring match on the SOC occupation category name (e.g. Software Developers), distinct from jobTitle
lawfirmOrAttorneyName	string	–	Substring match on the filing attorney's name or the law firm/business name
employerFein	string	–	Exact match on the sponsoring employer's FEIN (dashes/spaces ignored)
fullTimePositionOnly	boolean	false	Only emit full-time positions
totalWorkerPositionsMin / totalWorkerPositionsMax	int	–	Range on total worker positions requested on the LCA
wageMin / wageMax	int	–	Range on offered wage (wageRateFrom)
prevailingWageMin / prevailingWageMax	int	–	Range on prevailing wage
pwWageLevel	string	any	I / II / III / IV
wageUnitOfPay	string	any	Offered-wage pay period: Year / Hour / Week / Bi-Weekly / Month
employerState	string	any	Two-letter US state/territory code of the sponsoring employer's own address (distinct from worksite state)
hasAgentOrAttorney	string	any	yes (filed via an agent/attorney) / no (self-filed)
h1bDependentOnly	boolean	false	Only H-1B dependent employers
willfulViolatorOnly	boolean	false	Only listed willful violators
receivedDateFrom / receivedDateTo	string	–	ISO date YYYY-MM-DD range on received date
decisionDateFrom / decisionDateTo	string	–	ISO date YYYY-MM-DD range on decision date
employmentBeginDateFrom / employmentBeginDateTo	string	–	ISO date YYYY-MM-DD range on the requested employment start date
employmentEndDateFrom / employmentEndDateTo	string	–	ISO date YYYY-MM-DD range on the requested employment end date
maxItems	int	50	Hard cap (1–5000). A very high value combined with a restrictive filter may take several minutes since the whole quarterly file must be scanned once.
proxyConfiguration	object	Residential	Required. dol.gov blocks Apify's own IPs and the default datacenter proxy pool on these large downloads; a Residential proxy group is needed to reliably fetch the file.

Example: search by employer and worksite state

{
  "mode": "search",
  "employerName": "Google",
  "worksiteState": "CA",
  "visaClass": "H-1B",
  "maxItems": 100
}

Example: high-wage software engineering roles

{
  "mode": "search",
  "jobTitle": "software engineer",
  "wageMin": 150000,
  "fullTimePositionOnly": true,
  "maxItems": 200
}

Example: lookup exact case numbers

{
  "mode": "byCaseNumbers",
  "caseNumbers": ["I-200-25181-143022", "I-200-26083-726723"]
}

Example: a prior fiscal year, denied cases only

{
  "mode": "search",
  "fiscalYear": "FY2024",
  "caseStatus": "Denied",
  "maxItems": 500
}

Use cases

• Immigration law firms — research an employer's H-1B sponsorship history and prevailing wage levels before filing
• Compensation benchmarking — pull real offered/prevailing wages by SOC code, state, or employer to benchmark salary bands
• Journalism & policy research — analyze H-1B dependent employers, denial rates, or willful violator listings
• Recruiting & talent sourcing — identify which employers actively sponsor visas for a given job title or occupation
• Compliance monitoring — track your own or a competitor's LCA filings, case statuses, and worksite locations
• Academic research — bulk-export a fiscal year's disclosure data for labor-market analysis

FAQ

What is an LCA? A Labor Condition Application is a form employers file with the US Department of Labor before petitioning for an H-1B, H-1B1 (Chile/Singapore), or E-3 (Australia) visa worker. It attests to wage and working-condition commitments.

Where does this data come from? The US DOL Office of Foreign Labor Certification (OFLC) publishes cumulative quarterly disclosure files publicly at dol.gov. This actor is not affiliated with the US Department of Labor — it's a third-party tool built on that public dataset.

How often is the data updated? DOL publishes a new quarterly file roughly 4-6 weeks after each fiscal quarter closes. Fiscal Year runs October–September. Use fiscalYear: "latest" to always get the newest available file.

Why do older fiscal years only offer one option instead of per-quarter files? Once a fiscal year is closed, DOL's Q4 cumulative file already contains that entire year's records, so a single selection covers it.

What's the difference between wageRateFrom/wageRateTo and prevailingWage? wageRateFrom/wageRateTo is the wage the employer is offering the worker (a range if applicable). prevailingWage is the DOL-determined minimum wage for that occupation/location/experience level that the employer must meet or exceed.

What does h1bDependent mean? An employer is "H-1B dependent" if it meets DOL's headcount-ratio threshold for H-1B workers, which triggers additional attestation requirements. This field is omitted when the source marks it not-applicable (e.g., non-H-1B visa classes).

Why are some records missing attorney/agent fields? Not every employer uses an attorney or agent to file; those fields are simply omitted when the employer self-filed.

What are masterExemptionWorkerCount / masterExemptionDegrees? H-1B-dependent employers can exempt a worker from extra attestation requirements if that worker holds a US master's degree or higher (or foreign equivalent). DOL's separate "Appendix A" file records the exempt worker's institution, field of study, and degree date for cases that claim this exemption; this actor joins it in by case number automatically (no extra input needed). These fields are omitted for the (large majority of) cases that don't claim the exemption.

What is additionalWorksiteLocations? DOL lets an employer disclose up to 10 physical worksite locations per LCA in a separate "LCA Worksites" file. Most cases have just one (already reflected in the top-level worksiteAddress/worksiteCity/etc. fields), so this array is only added for the minority of cases with more than one disclosed location — giving you every location DOL published for that case, not just the primary one. Omitted entirely for single-location cases.

Can I get every record in a fiscal year? Yes — set maxItems up to 5000 with broad/no filters. The full file has 600K-900K rows; a very restrictive filter combined with a very high maxItems can take several minutes because the whole file is streamed once per run.

Is this actor US-only? Yes — the DOL LCA program covers US employment only, so worksiteState and employerState are always US states/territories.