🔔 DOL H-2A Places of Employment (FY2026 Q3, quarter-to-date)

Structured H-2A places-of-employment (Addendum B) — placement-level agricultural-employer demand — read directly from the official U.S. Department of Labor Office of Foreign Labor Certification class-A bulk disclosure workbook at https://www.dol.gov/media/H-2A_Addendum_B_Employment_FY2026_Q3.xlsx. One record per non-empty, de-duplicated placement row, carried source-native with the value unmodified.

Output is one h2a_employment_record row per result; billing is pay-per-event, the value event being one h-2a employment record (a $0.02 start fee per run, then $0.02 per h-2a employment record). Source: www.dol.gov.

📊 Sample Output

Real rows from run cDdKx9vv016jR77CV on build 0.1.3 (2026-09-19), the same input as the Quick start below — every value is as the source published it (emails masked, long text shortened):

case_number	job_order_number	business_name	place_city	place_state	requested_begin_date
H-300-25184-152191	JO-A-300-25184-152191	ROQUE FRAMS LLC	Zolfo springs	FLORIDA	2025-09-15
H-300-25184-152191	JO-A-300-25184-152191	Juarez Nursery Inc.	Zolfo Springs	FLORIDA	2025-09-10
H-300-25184-152191	JO-A-300-25184-152191	ROQUE FARMS LLC	FORT MEADE	FLORIDA	2025-09-10
H-300-25184-152191	JO-A-300-25184-152191	ROQUE FARMS LLC	Plant city	FLORIDA	2025-09-10
H-300-25184-152191	JO-A-300-25184-152191	ROQUE FARMS LLC	DOVER	FLORIDA	2025-09-15
H-300-25192-170298	JO-A-300-25192-170298	Eastern Agribusiness LLC	AYDEN	NORTH CAROLINA	2025-09-09
H-300-25192-170298	JO-A-300-25192-170298	Eastern Agribusiness LLC	LA GRANGE	NORTH CAROLINA	2025-09-09
H-300-25192-170298	JO-A-300-25192-170298	HAM FARMS	Snow Hill	NORTH CAROLINA	2025-09-09

The run finished with the status message: NORMAL: 50 unique rows (0 duplicates collapsed) from Fri, 07 Aug 2026 18:52:46 GMT. billable=50

✅ What you get

Each row is flat JSON with these fields (from the dataset schema and the sample run; a field the source does not publish for a given row is null):

• record_type (string/null) — e.g. h2a_employment_record
• source (string/null) — e.g. h2a-employment-locations
• program (string/null) — e.g. H-2A
• case_number (string/null) — e.g. H-300-25184-152191
• job_order_number (string/null) — e.g. JO-A-300-25184-152191
• business_name (string/null) — e.g. ROQUE FRAMS LLC
• place_city (string/null) — e.g. Zolfo springs
• place_state (string/null) — e.g. FLORIDA
• requested_begin_date (string/null) — e.g. 2025-09-15
• requested_end_date (string/null) — e.g. 2026-06-15
• total_workers (number/string/null) — e.g. 30
• natural_grain (string/null) — e.g. H-300-25184-152191 | JO-A-300-25184-152191 | ROQUE FRAMS LLC | Zolfo springs | F
• record_key (string/null) — e.g. 1eab7055cf271a0d5b349b10f4d373dd
• quarter_to_date (string/null) — e.g. FY2026 Q3
• source_attribution (string/null) — e.g. U.S. Department of Labor, Office of Foreign Labor Certification
• changes_indicated (string/null) — e.g. reformatted from the DOL OFLC disclosure workbook to JSON; values unmodified; al
• third_party_content (string/null) — e.g. none — official U.S. Department of Labor OFLC disclosure data; no third-party ri
• allowlist_note (string/null) — e.g. FIELD CEILING (placement-level): case identifier, job-order identifier, agricult
• employment_note (string/null) — e.g. the H-2A Addendum B PLACES-OF-EMPLOYMENT table — PLACEMENT-LEVEL employer demand
• grain_note (string/null) — e.g. CASE_NUMBER is NOT unique — one H-2A case has many places of employment. The rec
• quarter_to_date_note (string/null) — e.g. FY2026 Q3 QUARTER-TO-DATE living workbook — a moving cut refreshed through the q
• source_url (string/null) — e.g. https://www.dol.gov/media/H-2A_Addendum_B_Employment_FY2026_Q3.xlsx
• release_date (string/null) — e.g. Fri, 07 Aug 2026 18:52:46 GMT
• observed_at (string/null) — e.g. 2026-09-19T18:16:34Z
• release_checksum (string/null) — e.g. 1562c35c3a3d000c53b030de8639b820:1786128766.162314
• license (string/null) — e.g. U.S. public domain — a work of the U.S. Government (17 U.S.C. sec.105). U.S. Dep
• attribution (string/null) — e.g. U.S. Department of Labor, Office of Foreign Labor Certification (https://www.dol

What a record is

One h2a_employment_record per place-of-employment placement: the case identifier (case_number), the job-order identifier (job_order_number), the agricultural business (business_name), the place of employment city + state (place_city, place_state), the requested begin / end dates (requested_begin_date, requested_end_date), and the total workers (total_workers) requested at that placement.

The field ceiling — placement facts only

This is a placement addendum, so the field ceiling is deliberately tight: case identifier, job-order identifier, agricultural business, place-of-employment city + state (coarse geography), requested begin / end dates, and total workers only. Every street address, postal code, and free-text additional-place-of-employment information column is dropped at ingest and never emitted — the code only ever copies the allow-listed columns. This is verified by an offline test that feeds a row carrying street/postal/free-text values and asserts none reach output, plus a live leak check on the real file.

⚙️ Sample inputs

1. Quick start — the Store example (this is what the sample above came from)

{
  "maxRecords": 50
}

The sample run charged exactly: 2 × $0.02 apify-actor-start + 50 × $0.02 h2a_employment_record = $1.04 on the Free tier — every delivered row was billed.

2. A smaller, narrowed run

{
  "maxRecords": 5
}

Caps the run at 5 rows — about $0.12 on the Free tier ($0.02 start + 5 × $0.02).

3. A full-size run

{
  "maxRecords": 2500
}

Up to 2500 rows (the schema default for maxRecords) — about $50.02 on the Free tier ($0.02 start + 2500 × $0.02) if the source has that many.

🧾 JSON sample record

One real record from run cDdKx9vv016jR77CV, exactly as it lands in the dataset (emails masked, long text shortened):

{
  "record_type": "h2a_employment_record",
  "source": "h2a-employment-locations",
  "program": "H-2A",
  "case_number": "H-300-25184-152191",
  "job_order_number": "JO-A-300-25184-152191",
  "business_name": "ROQUE FRAMS LLC",
  "place_city": "Zolfo springs",
  "place_state": "FLORIDA",
  "requested_begin_date": "2025-09-15",
  "requested_end_date": "2026-06-15",
  "total_workers": 30,
  "natural_grain": "H-300-25184-152191 | JO-A-300-25184-152191 | ROQUE FRAMS LLC | Zolfo springs | FLORIDA | 2025-09-15 | 2026-06-15 | 30",
  "record_key": "1eab7055cf271a0d5b349b10f4d373dd",
  "quarter_to_date": "FY2026 Q3",
  "source_attribution": "U.S. Department of Labor, Office of Foreign Labor Certification",
  "changes_indicated": "reformatted from the DOL OFLC disclosure workbook to JSON; values unmodified; allow-listed structural columns only",
  "third_party_content": "none — official U.S. Department of Labor OFLC disclosure data; no third-party rights/trademarks/logos",
  "allowlist_note": "FIELD CEILING (placement-level): case identifier, job-order identifier, agricultural business, place-of-employment city + state (coarse) geography, requested begin/end dates and total workers ONLY. Street address, postal code and free-text ",
  "employment_note": "the H-2A Addendum B PLACES-OF-EMPLOYMENT table — PLACEMENT-LEVEL employer demand (where the work is, over which requested dates, for how many workers). This is the WHERE / HOW-MANY placement addendum, NOT the certification decision facts: i",
  "grain_note": "CASE_NUMBER is NOT unique — one H-2A case has many places of employment. The record key is a FULL-ROW MD5 over the emitted natural grain (case, job order, business, city, state, dates, workers); exact-duplicate placement rows collapse and a",
  "quarter_to_date_note": "FY2026 Q3 QUARTER-TO-DATE living workbook — a moving cut refreshed through the quarter, not a final annual file; vintage = source ETag + Last-Modified carried on the run_receipt.",
  "source_url": "https://www.dol.gov/media/H-2A_Addendum_B_Employment_FY2026_Q3.xlsx",
  "release_date": "Fri, 07 Aug 2026 18:52:46 GMT",
  "observed_at": "2026-09-19T18:16:34Z",
  "release_checksum": "1562c35c3a3d000c53b030de8639b820:1786128766.162314",
  "license": "U.S. public domain — a work of the U.S. Government (17 U.S.C. sec.105). U.S. Department of Labor, Office of Foreign Labor Certification disclosure data: used, reproduced and distributed without permission and credited to the U.S. Department",
  "attribution": "U.S. Department of Labor, Office of Foreign Labor Certification (https://www.dol.gov/) — public domain"
}

🔧 How it works

Transport. Plain HTTPS from the Apify platform, no proxy. robots.txt is read first and a disallowed path is never fetched. Every request carries an identified contact User-Agent. Pacing: CRAWL_DELAY=0.0.

Terminal states. A run ends NORMAL, CAPPED (your cap was reached), PARTIAL (something was withheld and the message says what), GENUINE_EMPTY (the source was read and truly had nothing in scope) or BLOCKED (the source refused or changed shape — the run FAILS loud and bills nothing). A zero-row run is never reported as a silent success.

Charging. Each h-2a employment record is charged at the moment it is pushed (h2a_employment_record); a row that fails to charge is not delivered, so the dataset count always equals the charged count.

A full-row key — one case has many places of employment

CASE_NUMBER is not unique: a single H-2A case lists many places of employment (about 10,364 cases across 188,580 placement rows). The record key is a full-row MD5 over the emitted natural grain — case, job order, business, city, state, requested dates and total workers — and exact-duplicate placement rows collapse and are never billed twice. The readable natural_grain is carried alongside the key.

Placement demand — not the certification decision

This is the where / how-many placement addendum (employer demand by location and worker count), not the certification decision facts. The H-2A certification master (h2a-labor-certifications — employer, occupation, SOC, wage, worksite, dates, statuses) is a separate cell; this Addendum-B placement table and that certification master are never conflated. An employment_note records this on every record.

Quarter-to-date — a living workbook, not a final file

This is the FY2026 Q3 quarter-to-date workbook: a moving cut refreshed through the quarter, not a final annual file. A quarter_to_date label rides every record and the run receipt carries the source ETag and Last-Modified as the vintage. The workbook's declared sheet dimension is padded with blank rows; only rows carrying a case_number are data — blank padding is skipped and never billed (non-empty-row law).

Door

Only the official DOL OFLC bulk disclosure workbook on www.dol.gov/media is read (public, logged-out, no API key). No implied DOL affiliation or endorsement.

Source & licence

U.S. public domain — a work of the U.S. Government (17 U.S.C. sec.105). U.S. Department of Labor, Office of Foreign Labor Certification disclosure data: used, reproduced and distributed without permission and credited to the U.S. Department of Labor (https://www.dol.gov/); no implied DOL affiliation or endorsement; third-party rights/trademarks/logos excluded. https://www.dol.gov/agencies/eta/foreign-labor/performance

What is not done. No login, no cookie or CAPTCHA bypass, no private or personal-account data, no browser automation.

💰 Pricing example

Event	Free	Bronze	Silver	Gold
Actor Start (apify-actor-start)	$0.02	$0.02	$0.02	$0.02
H-2A employment record (h2a_employment_record)	$0.02	$0.02	$0.02	$0.01

Worked at the live Free-tier price:

• 8 h-2a employment records: $0.02 start + 8 × $0.02 = $0.18
• 25 h-2a employment records: $0.02 start + 25 × $0.02 = $0.52
• 2500 h-2a employment records: $0.02 start + 2500 × $0.02 = $50.02

A run that delivers zero rows charges the $0.02 start fee only. A BLOCKED run (source refused) fails loud and charges no value event. The start fee is charged once per GB of run memory; the default run memory is 4096 MB.

Yield on the sample run: NORMAL: 50 unique rows (0 duplicates collapsed) from Fri, 07 Aug 2026 18:52:46 GMT. billable=50. maxRecords is a hard ceiling on what is delivered and billed, never a target.

⚖️ Legal & ToS

This actor reads public, logged-out pages and feeds published by www.dol.gov. It collects only what the source publishes to any visitor, keeps to the source's robots rules (checked on every run), identifies itself with a contact User-Agent, and does not access accounts, private data or anything behind authentication. Use the output in line with the source's terms and your local law; the intended use is B2B research and monitoring.

❓ FAQ

Q: Do I need an API key or a login?
A: No. The source (www.dol.gov) is read logged-out; the input schema has no key field and the actor carries no secrets.

Q: Why did my run return 0 rows?
A: Read the run's status message. GENUINE_EMPTY means the source was read and had nothing in scope for your input; BLOCKED means the source refused and the run failed without billing a value event — retry later or narrow the input. A zero-row run bills the start fee only.

Q: How many rows can one run return?
A: Up to maxRecords (default 2500). Raise the cap for a bigger run; you pay per delivered row.

Q: How fresh is the data?
A: Every run reads the source live at run time; nothing is cached between runs. Put it on a schedule for a continuous feed.

Q: What formats can I export?
A: The dataset downloads as JSON, CSV, Excel, XML or RSS from the run's Dataset tab or the Apify API, and any run can push to a webhook or integration.

Q: How is this different from the other NexGen Watch actors actors?
A: Same output shape and billing model; this one covers www.dol.gov. The siblings under Related Actors cover the other sources or slices — run several on one schedule for a combined feed.

Q: Are there rate limits?
A: The actor paces itself against the source (CRAWL_DELAY=0.0) and honours its robots rules; there is no per-buyer limit beyond your Apify plan's concurrency.

🆘 Troubleshooting

• Run FAILED with BLOCKED → the source refused the request or changed its page shape → nothing was billed beyond the start fee; retry after a while, and if it persists open an Issue with the run id.
• Status says CAPPED → your cap (maxRecords) was reached → raise it for a bigger run.
• Input validation error on start → a field is outside the schema's allowed values → start from the Quick start block and change one field at a time.
• Run TIMED-OUT → a very wide request on a slow day → raise the run timeout in Run options or narrow the input; what was delivered before the timeout is still in the dataset.

🔗 Related Actors

• France SIRENE Bulk Business Roster — same family, different source
• France Training Provider Registry — same family, different source
• EPA GHGRP Parent-Company Ownership Ledger — same family, different source
• DOL H-2A Labor Certifications (FY2026 Q3, quarter-to-date) — same family, different source
• DOL H-2B Labor Certifications (FY2026 Q3, quarter-to-date) — same family, different source
• Hong Kong New Companies Feed — same family, different source
• 🏢 About NexGenData — NexGen Watch is NexGenData's fleet of 256 public monitoring and lookup actors built on official sources, pay-per-result. Browse the catalog at apify.com/nexgenwatch.

⭐ Found this useful?

If this actor saved you a manual check, a quick review on the Apify Store helps other teams find it. Feature request or a source that changed? Open it from the Issues tab — every one is read.