# Contractor License Leads - Multi-State, 22 States + Phone (`scrapersdelight/contractor-license-leads-email-scraper`) Actor

$1 per 1,000 licences; $0.80 per 1,000 on Business and higher plans. Licensed contractors from 22 US state registers in one schema: licence number, trade, status, expiry, owner, phone (19 states), email where published, address. Filter by trade, county, city, ZIP.

- **URL**: https://apify.com/scrapersdelight/contractor-license-leads-email-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Lead generation, Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 per contractor licence returneds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Contractor License Leads - Multi-State, 22 States + Phone

Licensed contractors from **22 US state contractor registers in one schema**. Pick the states and trades you want, narrow to counties, cities or ZIP codes if you like, and get one row per licence: licence number, trade, status, expiry, business name, owner or qualifier, **phone** (published by 19 of the 22 registers), **email** where the register publishes it, street address and county.

- **22 states, one schema** - Alabama, Arizona, Arkansas, California, Connecticut, Florida, Iowa, Massachusetts, Minnesota, Mississippi, Nebraska, Nevada, New York, Ohio, Oklahoma, Oregon, Tennessee, Texas, Virginia, Washington, West Virginia, Wyoming. The same column names whatever the state, so a multi-state list imports in one go.
- **Phone in 19 states, email straight from 8 registers** (Arkansas, Iowa, Massachusetts, New York City DOB, Tennessee, Virginia, and sparsely Ohio and Nebraska).
- **One trade vocabulary** - `electrical`, `hvac`, `plumbing`, `roofing`, `general` and 33 more, mapped to each state's own licence classes.
- **Deduplicated on the register's licence number** - a licence found by two of your searches is delivered and charged once.
- **Active-only and expiring-soon filters** - active licences by default; set `expiringWithinDays` for a renewal-window list.
- **Bond, insurance and personnel where the register has them** - California bond + workers' comp, Oregon bond + liability insurance, Arizona bond + personnel, Oklahoma liability + workers' comp insurers, Mississippi officers.
- **Optional verified website + email** for rows whose register publishes none: the website is kept **only if it shows that licence number or the register's phone**.
- **Straight from the registers** - no login, no API key; every run reads the live register.

**$1 per 1,000 licences, $0.80 per 1,000 on Business and higher Apify plans.** Same price for every state. Optional verified email: $2.10 per 1,000 emails found. No start fee.

### Coverage

Measured on real runs through this actor (2026-09-30, up to 300 licences per frame, two frames per state). Phone and email columns show `frame 1 · frame 2` as filled / delivered.

| State | Register | Register size (2026-09-30) | Phone | Email | Also on every row (where published) |
|---|---|---|---|---|---|
| Alabama | Licensing Board for General Contractors | 9,899 licences | 300/300 · 300/300 | - | classifications, bid limit, expiry |
| Arizona | Registrar of Contractors (ROC) | 58,409 active | 299/300 · 300/300 | - | qualifying party, personnel, bond company + amount, entity type, class type |
| Arkansas | Contractors Licensing Board | 18,300 roster rows | 201/201 · 299/300 | 189/201 · 298/300 | county, officers, entity type, classes + specialties, bid limit |
| California | Contractors State License Board (CSLB) | active licences, by county | 300/300 · 300/300 | - | county, bond, workers' comp, business type, classifications |
| Connecticut | Dept. of Consumer Protection (DCP) | 46,124 active contractor credentials | **not published** | - | credential, holder, business type, issue/expiry |
| Florida | Dept. of Business & Professional Regulation (DBPR) | search by county/city | **not published** | - | qualifier, DBA, county, rank, special qualifications |
| Iowa | Division of Labor, contractor registration | 17,898 active | 278/278 · 293/294 | 274/278 · 284/294 | owner, county, NAICS activity |
| Massachusetts | OCABR Home Improvement Contractor registry | searched by city / ZIP / county / statewide | 300/300 · 300/300 | 296/300 · 299/300 | contact names |
| Minnesota | Dept. of Labor and Industry (DLI) | business licences in 7 DLI exports | 294/300 · 287/300 | - | licence subtype, enforcement flag |
| Mississippi | State Board of Contractors | 13,159 active | 94/95 · 300/300 | - | county, classes, qualifying names, officers, first issue |
| Nebraska | Dept. of Labor, contractor registration | 20,385 current | 111/111 · 300/300 | 2/111 · 32/300 | legal name + trade name, business entity, workers' comp status |
| Nevada | State Contractors Board (NSCB) | 19,237 active | 68/68 · 300/300 | - | classifications, monetary limit |
| New York | NYS DOL Contractor Registry; NYC DOB licences; NYC DCWP home improvement | 14,846 + 13,259 + 13,385 | 300/300 · 299/300 | 296/300 (DOB) · - | business type, compliance flags (registry), borough/county (NYC) |
| Ohio | Construction Industry Licensing Board (commercial) | 12,479 | 199/289 · 208/300 | 16/289 · 9/300 | licence holder |
| Oklahoma | Construction Industries Board - roofing | 1,957 in good standing | 165/165 · 300/300 | - | registered person, liability insurer, workers' comp, commercial endorsement |
| Oregon | Construction Contractors Board (CCB) | 45,599 licences | 300/300 · 300/300 | - | county, responsible managing individual, bond, liability insurance |
| Tennessee | Board for Licensing Contractors | 20,495 active | 249/253 · 158/158 | 246/253 · 157/158 | qualifying agents, classifications, monetary limit |
| Texas | Dept. of Licensing and Regulation (TDLR) | 36,067 contractor licences | 300/300 (electrical) · 0/300 (A/C) | - | owner, county, mailing address |
| Virginia | DPOR Board for Contractors | 54,246 firms (Class A/B/C) | **not published** | 197/300 · 254/300 | class, specialties |
| Washington | Labor & Industries (L\&I) | 76,113 active | 300/300 · 300/300 | - | principal, business type, UBI, specialties |
| West Virginia | Contractor Licensing Board | 17,545 | 89/90 · 299/300 | - | county, classifications, DBA |
| Wyoming | Dept. of Fire Prevention & Electrical Safety | 1,136 active | 300/300 · 252/252 | - | electrical / limited-voltage level |

Texas publishes no phone for A/C contractors (their search results and licence pages carry none either); for the other TDLR contractor types phone fill is 97-100%. Florida, Connecticut and Virginia publish no phone for these licences; Virginia publishes an email instead.

#### Example rows (real, from the runs above)

Fields a state does not publish are present as `null` / `[]` on every row, so every row has the same columns; they are left out here for readability.

**Tennessee** (phone + email from the register)

```json
{
  "state": "TN",
  "licenseKey": "TN:14891",
  "licenseNumber": "14891",
  "licenseType": "Tennessee contractor licence",
  "licenseTypeCode": "BC13 | C | HRA | MCA",
  "classifications": ["BC13 - 13. Site and Subdivision Development (BC-13)", "C - MU-C Grading and Drainage", "HRA - HRA Highway, Railroad, and Airport", "MCA - CMC-A Plumbing and Gas Piping"],
  "trades": ["plumbing", "earthwork_paving", "general_engineering"],
  "status": "Active",
  "isActive": true,
  "issueDate": "1992-11-30",
  "expirationDate": "2027-11-30",
  "daysUntilExpiry": 426,
  "businessName": "Earhart, J. S. Plumbing, Inc.",
  "ownerName": "J. Sterling Earhart, Jr",
  "phone": "(615) 754-6462",
  "phoneE164": "+16157546462",
  "email": "earhartplumbing@tds.net",
  "emailSource": "register",
  "address": "560 CARVER LANE",
  "city": "MOUNT JULIET",
  "addressState": "TN",
  "zip": "37122",
  "licenseSubtype": "Aggregate Limit $ 1,500,000.00",
  "sourceRegister": "Tennessee Board for Licensing Contractors"
}
```

**Oregon** (bond + liability insurance)

```json
{
  "state": "OR",
  "licenseKey": "OR:100310",
  "licenseNumber": "100310",
  "licenseType": "Residential General Contractor",
  "licenseTypeCode": "RGC",
  "trades": ["general"],
  "status": "Active",
  "isActive": true,
  "issueDate": "1994-06-22",
  "expirationDate": "2028-07-30",
  "businessName": "HABITAT FOR HUMANITY PORTLAND METRO EAST",
  "ownerName": "JESSE GUINN WITHERS",
  "phone": "(503) 287-9529",
  "phoneE164": "+15032879529",
  "address": "PO BOX 11527",
  "city": "PORTLAND",
  "addressState": "OR",
  "zip": "97211",
  "county": "Multnomah",
  "bondSuretyCompany": "TRAVELERS CASUALTY & SURETY CO OF AMERICA",
  "bondAmount": 25000,
  "bondExpirationDate": "2028-07-30",
  "liabilityInsuranceCompany": "ACE AMERICAN INSURANCE CO",
  "liabilityInsuranceAmount": 1000000,
  "liabilityInsuranceExpirationDate": "2027-04-01",
  "sourceRegister": "Oregon Construction Contractors Board (CCB)"
}
```

**Iowa** (email + county)

```json
{
  "state": "IA",
  "licenseKey": "IA:C101875",
  "licenseNumber": "C101875",
  "licenseType": "Iowa contractor registration",
  "classifications": ["Electrical and Wiring Installation"],
  "trades": ["electrical"],
  "status": "Active",
  "isActive": true,
  "issueDate": "2025-09-09",
  "expirationDate": "2026-10-08",
  "daysUntilExpiry": 8,
  "businessName": "CK ELECTRIC LLC",
  "ownerName": "CURTIS KESTERSON",
  "phone": "(515) 559-3301",
  "phoneE164": "+15155593301",
  "email": "ckelectricllc@gmail.com",
  "emailSource": "register",
  "address": "POBOX 272",
  "city": "ANKENY",
  "addressState": "IA",
  "zip": "50021",
  "county": "POLK",
  "sourceRegister": "Iowa Division of Labor - Contractor Registration"
}
```

**Washington**

```json
{
  "state": "WA",
  "licenseKey": "WA:123ELES892CP",
  "licenseNumber": "123ELES892CP",
  "licenseType": "ELECTRICAL CONTRACTOR",
  "licenseTypeCode": "EC",
  "classifications": ["GENERAL"],
  "trades": ["electrical"],
  "status": "ACTIVE",
  "isActive": true,
  "issueDate": "2011-02-17",
  "expirationDate": "2027-02-17",
  "businessName": "123 Electric Service Inc",
  "ownerName": "Leber, Brett",
  "businessType": "Corporation",
  "phone": "(425) 455-2027",
  "phoneE164": "+14254552027",
  "address": "14725 NE 20TH ST D-12",
  "city": "Bellevue",
  "addressState": "WA",
  "zip": "98007",
  "licenseSubtype": "EC/01",
  "businessId": "602762749",
  "sourceRegister": "Washington State Department of Labor & Industries (L&I)"
}
```

### How to use it

1. Choose **States** (all 22 by default).
2. Choose **Trades** - `electrical` by default; see the table below. Each trade is mapped to the licence types that ARE that trade in each state's own register. Or give exact register codes in **Licence types**.
3. Optionally narrow with **Counties**, **Cities** and/or **ZIP codes**. Leave all three empty to search each state statewide.
4. Set **Max licences** and run. Export the dataset as CSV, Excel or JSON, or read it over the API.

`maxItems` is shared across the selected states: each round, every state still searching gets an equal share, and a state with fewer matches hands its share to the others.

#### Examples

Electricians and HVAC contractors in four metro counties across four states:

```json
{ "states": ["CA", "AZ", "WA", "TX"], "trades": ["electrical", "hvac"], "counties": ["Los Angeles", "Maricopa", "King", "Harris"], "maxItems": 500 }
```

Roofers with a phone number, every state that licenses roofers:

```json
{ "trades": ["roofing"], "requirePhone": true, "maxItems": 1000 }
```

Renewal list - licences expiring in the next 60 days in Tennessee and Iowa (both publish email):

```json
{ "states": ["TN", "IA"], "trades": [], "expiringWithinDays": 60, "maxItems": 500 }
```

Home improvement contractors around Boston, Hartford and Brooklyn:

```json
{ "states": ["MA", "CT", "NY"], "trades": ["home_improvement"], "counties": ["Suffolk, MA", "Hartford", "Kings"], "maxItems": 300 }
```

Exact register codes (an Arizona plumbing class, a Washington roofing specialty, Minnesota residential building contractors):

```json
{ "states": ["AZ", "WA", "MN"], "trades": [], "licenseTypes": ["AZ:CR-37", "WA:CC/CD", "MN:BC"], "maxItems": 200 }
```

### Input

| Input | Default | What it does |
|---|---|---|
| `states` | all 22 | State codes (or names): `AL`, `AZ`, `AR`, `CA`, `CT`, `FL`, `IA`, `MA`, `MN`, `MS`, `NE`, `NV`, `NY`, `OH`, `OK`, `OR`, `TN`, `TX`, `VA`, `WA`, `WV`, `WY`. |
| `trades` | `["electrical"]` | Trade keys from the table below. Common names are accepted (`plumbers`, `electrician`, `general contractor`, `a/c`). Empty + empty `licenseTypes` = every contractor licence type. |
| `licenseTypes` | - | Exact codes, added to the trades, as `STATE:code` - e.g. `CA:C-10`, `FL:0605`, `TX:Electrical Contractor`, `AZ:CR-37`, `WA:CC/CD`, `OR:RGC`, `NY:HIC`, `MN:BC`, `VA:RBC`, `NV:C15`, `MS:COM:S056`, `CT:HIC`. For Alabama, Arkansas, Iowa, Tennessee and West Virginia (registers that describe work in free text) the codes are the trade keys themselves, e.g. `AR:roofing`. |
| `counties` | - | County names (`Los Angeles`, `Maricopa`, `Miami-Dade`, `King`). A name in two selected states searches both; add `, FL` (or write `FL:Orange`) to pick one. Where a register publishes no county, the county's ZIP codes (Census ZCTA) are used. |
| `cities` | - | City names; add `, AZ` etc. to limit one to a state. |
| `zipCodes` | - | 5-digit ZIP codes; each is searched only in the state it belongs to. |
| `activeOnly` | `true` | Active licences only: the register's own status where it has one, else expiry today or later. Several registers list current licences only (California, Arizona, Iowa, Arkansas, Oregon, Virginia, West Virginia, Nevada, Nebraska). |
| `expiringWithinDays` | `0` (off) | Only licences expiring between today and this many days ahead. Registers without an expiry date (NYC DOB) return nothing with this on. |
| `requirePhone` | `false` | Drop rows without a phone. Florida, Connecticut and Virginia are skipped with this on. |
| `fetchDetails` | `true` | Read the per-licence page where a register keeps part of the record there: Florida (qualifier, DBA), Arizona (bond, entity type, personnel), Mississippi (expiry, county, classes), **Nebraska (phone and email)**. One extra small request per row in those states. |
| `enrichWebsiteEmail` | `false` | Find the business's own website and read its email - kept only when the site shows the licence number or the register phone (see below). |
| `websiteDiscovery` | `domain-guess` | With `enrichWebsiteEmail`: `domain-guess` (fast), `both` (guess, then one web search) or `search`. |
| `maxItems` | `60` | Total licences for the run, shared across the states. `0` = no limit. |
| `proxyConfiguration` | none | Not needed: every register answers direct requests. If set, used only as a fallback after two failed direct attempts. |

Counties, cities and ZIPs combine as **OR**: a row in any location you list is returned.

#### Trades

"text match" = the register describes the work in its own words (e.g. Arkansas "Heating, Ventilation, Air Conditioning, Refrigeration"), and the trade is read from that text.

| Trade (input value) | States that license it (register codes) |
|---|---|
| `electrical` - Electrical contractors | AL (text match); AR (text match); AZ (C-11, CR-11, R-11); CA (C-10); CT (ELC-U, ELC-L, ELC-S); FL (0801, 0805); IA (text match); MN (EA, EB, ER); MS (RES:RE, COM:S014, COM:E, COM:S719, COM:S560, COM:S734 +1); NE (22); NV (C02); NY (EF); OH (EL); TN (text match); TX (Electrical Contractor); VA (ELE); WA (EC); WV (text match); WY (Electrical Contractor) |
| `hvac` - HVAC / air conditioning & refrigeration | AL (text match); AR (text match); AZ (C-39, CR-39, R-39, R-39R, C-79, CR-79 +3); CA (C-20, C-38); CT (HTG-U, HTG-L); FL (0601, 0614); IA (text match); MN (MB); MS (RES:RH, COM:S056, COM:S116); NE (23); NV (C01, C21, C39); NY (OB); OH (HV, RE); TN (text match); TX (A/C Contractor); VA (HVA, REF); WA (CC/SM, EC/6A, EC/6B); WV (text match); WY (LM-H Contractor) |
| `plumbing` - Plumbing | AL (text match); AR (text match); AZ (C-37, CR-37, R-37, R-37R, C-77, CR-77); CA (C-36); CT (PLM-U, PLM-L); FL (0604, 0617); IA (text match); MN (PC, PR, EP); MS (RES:RP, COM:S107); NE (23); NV (C01); NY (MP); OH (PL); TN (text match); VA (PLB); WA (PC, CC/AD); WV (text match) |
| `roofing` - Roofing | AL (text match); AR (text match); AZ (C-42, CR-42, R-42); CA (C-39); FL (0603, 0616); IA (text match); MN (RR); MS (RES:S123, COM:S600); NE (19); NV (C15); OK (ROOFING, ROOFING-COMMERCIAL); TN (text match); VA (ROC); WA (CC/CD); WV (text match) |
| `general` - General / building / residential contractors | AL (text match); AR (text match); AZ (B, B-1, B-2, B-3, KB-1, KB-2); CA (B, B-2); CT (NHC, MCO); FL (0605, 0618, 0602, 0615, 0608, 0623); IA (text match); MN (BC); MS (RES:B, RES:RCM, COM:B, COM:S007); NE (1, 3, 4, 5, 7, 8 +1); NV (B, AB); NY (GC); OR (RGC, CGC1, CGC2); TN (text match); VA (RBC, CBC); WA (CC/01); WV (text match) |
| `home_improvement` - Home improvement / remodeling contractors | AL (text match); AR (text match); CT (HIC); IA (text match); MA (HIC); MN (CR); MS (RES:R, COM:S460); NE (6, 20); NY (HIC); TN (text match); VA (HIC, CIC); WV (text match) |
| `general_engineering` - General engineering | AL (text match); AR (text match); AZ (A, KA, B-4); CA (A); IA (text match); MS (COM:C, COM:A, COM:S090, COM:S373, COM:S118); NE (11, 12, 13); NV (A, AB); TN (text match); VA (H/H, MCC); WV (text match) |
| `mechanical` - Mechanical / boiler & steam fitting | AL (text match); AR (text match); AZ (C-4, CR-4, R-4, C-74, CR-74); CA (C-4); CT (HTG-U, HTG-L, MGV); FL (0606, 0620); IA (text match); MN (MB); MS (RES:M, COM:S006, COM:S032, COM:S729, COM:F, COM:S266); NE (24); NV (C38, C39); OH (HV, HY); TN (text match); VA (GFC, NGF, LPG); WA (CC/AC); WV (text match) |
| `pool_spa` - Swimming pool & spa | AL (text match); AR (text match); AZ (A-9, A-19, B-5, B-5R, B-6, B-10 +5); CA (C-53); FL (0607, 0621); IA (text match); MS (COM:S144); NE (56); TN (text match); VA (POL); WA (CC/RB); WV (text match) |
| `solar` - Solar | AL (text match); AR (text match); AZ (C-78, CR-78, C-77, CR-77, R-37, C-79 +7); CA (C-46); CT (ELC-S, STC); FL (0611, 0633); IA (text match); MS (RES:RS, COM:S708); NV (C37); TN (text match); VA (AES); WV (text match) |
| `sheet_metal` - Sheet metal | AL (text match); AR (text match); AZ (C-45, CR-45, R-45); CA (C-43); CT (SHM-L); FL (0609, 0624); IA (text match); MS (COM:S136); NV (C13); TN (text match); WV (text match) |
| `alarm_low_voltage` - Alarm / low-voltage systems | AL (text match); AR (text match); AZ (C-67, CR-67, R-67); CA (C-7); FL (0802, 0803, 0806, 0807, 0809, 0810 +1); IA (text match); MN (TS, SC); MS (COM:S602, COM:S014, COM:S560, COM:S436, COM:S714); NE (38); NV (C42); TN (text match); VA (ESC, FAS); WA (EC/06, CC/SQ); WV (text match); WY (LV-G, LV-C, LV-A, LV-X, LV-LS, LV-T, LV-S Contractor) |
| `sign_electrical_specialty` - Sign & electrical specialty | AL (text match); AR (text match); AZ (C-38, CR-38); CA (C-45); FL (0804, 0808); IA (text match); MN (SB); MS (COM:S137, COM:S616); NE (2); NV (C06); NY (SH); TN (text match); TX (Electrical Sign Contractor); VA (BSC); WA (CC/SX, EC/04); WV (text match); WY (LM-S Contractor) |
| `underground_utility` - Underground utility, pipeline & sanitation | AL (text match); AR (text match); AZ (A-12, CR-80, A-16, C-41, CR-41, R-41); CA (C-34, C-42); FL (0610, 0625); IA (text match); MN (PB); MS (COM:S110, COM:S473, COM:S723, COM:S714, COM:S280, COM:S545 +1); NE (9, 10); NV (C27); TN (text match); VA (UUC, CDS, ADS); WA (CC/RG, CC/SU); WV (text match) |
| `elevator` - Elevator | AL (text match); AR (text match); AZ (C-12, CR-12, R-12); CA (C-11); CT (ELV-U, ELV-C, ELV-H, ELV-L); IA (text match); MN (CE, LC); MS (COM:S033, COM:S606); NV (C07); TN (text match); TX (Elevator Contractor); VA (EEC); WA (LC, CC/BL); WV (text match); WY (LM-E Contractor) |
| `well_drilling` - Water well drilling & pump installation | AL (text match); AR (text match); AZ (C-53, CR-53, R-53); CA (C-57); CT (WWC, WNC, WEC, WGC, WDC); IA (text match); MS (COM:S175); NV (C23); TN (text match); TX (Water Well Driller/Pump Installer); VA (WWP); WA (CC/WD, EC/03, EC/3A); WV (text match); WY (LM-W Contractor) |
| `fire_protection` - Fire protection | AL (text match); AR (text match); AZ (C-16, CR-16, R-16); CA (C-16); CT (FRP-U, FRP-L); IA (text match); MS (COM:S265, COM:S728, COM:S043); NV (C41); NY (FS); TN (text match); VA (SPR, FSP, FAS); WA (CC/BO); WV (text match); WY (Chemical Suppression) |
| `insulation` - Insulation & acoustical | AL (text match); AR (text match); AZ (C-40, CR-40, R-40, C-1, CR-1); CA (C-2); IA (text match); MS (COM:S729, COM:S701); NE (25); TN (text match); VA (INS); WA (CC/SO); WV (text match) |
| `framing_carpentry` - Framing, cabinets & finish carpentry | AL (text match); AR (text match); AZ (C-7, CR-7, R-7, C-60, CR-60, R-60 +3); CA (C-5, C-6); IA (text match); MS (COM:S400, COM:S726, COM:S565); NE (16, 29); NV (C03); TN (text match); WA (CC/SB, CC/SL); WV (text match) |
| `concrete_masonry` - Concrete & masonry | AL (text match); AR (text match); AZ (C-9, CR-9, R-9, C-31, CR-31, R-31); CA (C-8, C-29); IA (text match); MS (COM:S182, COM:S187, COM:S555, COM:S478, COM:S091); NE (14, 17); NV (C05, C18); TN (text match); VA (CEM, BRK); WA (CC/BI, CC/BZ); WV (text match) |
| `drywall_plaster` - Drywall, lathing & plastering | AL (text match); AR (text match); AZ (C-10, CR-10, R-10, C-36, CR-36, R-36 +1); CA (C-9, C-35); IA (text match); MS (COM:S617, COM:S086); NE (25); NV (C17); TN (text match); VA (DRY); WA (CC/BK, CC/SP, CC/RA); WV (text match) |
| `earthwork_paving` - Earthwork, paving & highway | AL (text match); AR (text match); AZ (A-5, CR-2, R-2, A-14, CR-69, R-13 +2); CA (C-12, C-32); IA (text match); MS (COM:S603, COM:S222, COM:S187, COM:S627, COM:S612); NE (31, 54); TN (text match); VA (PAV, UUC); WA (CC/SI, CC/SS); WV (text match) |
| `fencing` - Fencing | AL (text match); AR (text match); AZ (C-14, CR-14, R-14); CA (C-13); IA (text match); MS (COM:S041); NE (55); NV (C25); TN (text match); WA (CC/BN); WV (text match) |
| `flooring_tile` - Flooring & tile | AL (text match); AR (text match); AZ (C-8, CR-8, R-8, C-48, CR-48, R-48); CA (C-15, C-54); IA (text match); MS (COM:S046, COM:S587); NE (27, 28); NV (C16, C19, C20); TN (text match); VA (FLR, TMC); WA (CC/SK, CC/RE); WV (text match) |
| `glazing` - Glazing | AL (text match); AR (text match); AZ (C-65, CR-65, R-65); CA (C-17); CT (GLZ-F, GLZ-A); IA (text match); MS (COM:S050); NE (18); NV (C08); TN (text match); VA (GLZ); WA (CC/BP); WV (text match) |
| `demolition` - Building moving & demolition | AL (text match); AR (text match); AZ (C-57, CR-57, R-57); CA (C-21); CT (DMCR); IA (text match); MS (COM:S022, COM:S614); NE (54); NV (C31); TN (text match); WA (CC/SF); WV (text match) |
| `asbestos_hazmat` - Asbestos & hazardous substance removal | AL (text match); AR (text match); CA (C-22, ASB, HAZ); IA (text match); MS (COM:S715); NE (44); TN (text match); VA (ASB, LAC, RMC); WA (CC/XX); WV (text match) |
| `landscaping_tree` - Landscaping & tree | AL (text match); AR (text match); AZ (C-21, CR-21, R-21); CA (C-27, C-49); IA (text match); MS (COM:S073, COM:S612); NE (42); NV (C10); TN (text match); VA (LSC, ISC); WA (CC/BW, CC/RF, CC/BV); WV (text match) |
| `painting` - Painting & decorating | AL (text match); AR (text match); AZ (C-34, CR-34, R-34); CA (C-33); IA (text match); MS (COM:S732, COM:S129); NE (26); NV (C04); TN (text match); VA (PTC); WA (CC/CB); WV (text match) |
| `steel_welding_metal` - Structural & reinforcing steel, welding, ornamental metal | AL (text match); AR (text match); AZ (A-11, CR-17, R-17, C-24, CR-24, R-24 +5); CA (C-23, C-50, C-51, C-60); IA (text match); MS (COM:S098, COM:S731, COM:S619, COM:S146, COM:S268); NE (15, 53); NV (C14); TN (text match); VA (STL); WA (CC/RI, CC/SY, CC/CG); WV (text match) |
| `locks_security` - Locks & security equipment | CA (C-28); NE (39); OR (OCLS, RLSC); WA (CC/SQ) |
| `water_conditioning` - Water conditioning | AZ (C-54, CR-54, R-54); CA (C-55); MN (WC); NV (C30); WA (CC/CP) |
| `manufactured_housing` - Manufactured housing | AL (text match); AR (text match); CA (C-47); IA (text match); MN (MI); TN (text match); VA (MHC, IBC); WA (CC/SR); WV (text match) |
| `handyman` - Minor home improvements / handyman | AL (text match); AR (text match); AZ (R-62); IA (text match); NV (C03); TN (text match); WA (CC/HM); WV (text match) |
| `appliance_installation` - Appliance installation | AZ (CR-63, R-63); TX (Appliance Installation Contractor); WA (CC/BG) |
| `specialty_structure` - Structural / specialty construction (FL specialty licences) | FL (0612, 0626) |
| `tank_pollutant_storage` - Pollutant storage, tank lining & tank testing | FL (0613, 0619, 0622) |
| `public_works` - Registered public-work contractors (any trade) | NY (REG) |

A state that does not license a trade at state level is skipped for it, and the run says so in its status and `RUN_SUMMARY` (Oregon's CCB licenses by business scope, not trade; Oklahoma's open register is roofing; Massachusetts' is home improvement; Wyoming licenses electrical work only; Ohio licenses commercial electrical, HVAC, hydronics, plumbing and refrigeration contractors).

### Website + email (optional)

Turn on **Find website + email** (`enrichWebsiteEmail: true`) for rows whose register publishes no email. For each such licence the actor:

1. **finds a candidate website** - by default it tries the `.com` names the business or DBA name spells (never a person's "LAST, FIRST" name); with `websiteDiscovery: "both"` it also runs one web search when the guess finds nothing;
2. **keeps the website only when the page shows that licence number** (next to a "licence"/"#"/"ROC" cue) **or the phone the register publishes** - a same-named business elsewhere, a directory listing or a parked domain is never attached;
3. **reads the site's contact details** (mailto links, JSON-LD, Cloudflare-protected and "(at)/(dot)" addresses), keeps emails on the site's own domain or a personal-mail provider, drops placeholders and third parties such as a web designer's credit, and checks the email domain has a mail server (MX).

Rows whose register already publishes an email keep it (`emailSource: "register"`) and are not searched or charged. Measured on California, Texas and Florida electrical licences (50 per state per sample): verified email for 2-7 of 50 California rows, 5-6 of 50 Texas rows and 0-2 of 50 Florida rows with the default guess; guess + search found 9 / 5 / 1 of 50 on the second sample. Yield depends on the area.

Each enriched row gets `website`, `websiteVerifiedBy` (`licenseNumber` or `phone`), `websiteFoundBy`, `email` (`emailSource: "website"`), `additionalEmails`, `emailConfidence` (`high` = own domain + MX; `medium`; `low` = personal-mail address), `emailMxVerified` and `enrichmentStatus`.

### Output fields

| Field | Meaning |
|---|---|
| `state` | Two-letter state code |
| `licenseKey` | Dedupe key: state + the register's own licence number (plus the licence type where a register reuses numbers across types) |
| `licenseNumber` | The register's licence / registration / certificate number |
| `licenseType` / `licenseTypeCode` | Register's licence type and its code(s) |
| `classifications` | Every class / specialty / endorsement the register lists for the licence |
| `trades` | Normalised trade keys for the licence |
| `status` / `isActive` | Register status; `isActive` is the boolean behind the active-only filter |
| `issueDate` / `expirationDate` / `daysUntilExpiry` | ISO dates; days until expiry from today |
| `businessName` / `dbaName` / `ownerName` | Business, DBA, and the owner / qualifier / principal / responsible person where published |
| `businessType` | Corporation, LLC, sole proprietor ... where published |
| `phone` / `phoneE164` | `(510) 329-1825` and `+15103291825` (E.164 only for a clean 10-digit number) |
| `email` / `emailSource` | An email the register publishes (`register`), or one found by the opt-in enrichment (`website`) |
| `address`, `address2`, `city`, `addressState`, `zip`, `county` | Business address as the register publishes it (county only where the register has one) |
| `mailingAddress`, `mailingCity`, `mailingState`, `mailingZip` | Texas mailing address |
| `bondSuretyCompany`, `bondNumber`, `bondAmount`, `bondEffectiveDate`, `bondExpirationDate`, `bondCancellationDate` | Contractor bond (California, Oregon, Arizona) |
| `liabilityInsuranceCompany`, `liabilityInsuranceAmount`, `liabilityInsuranceExpirationDate` | Liability insurance (Oregon, Oklahoma) |
| `workersCompCoverageType`, `workersCompInsuranceCompany`, `workersCompPolicyNumber`, `workersCompEffectiveDate`, `workersCompExpirationDate`, `workersCompCancellationDate` | Workers' compensation (California; Oklahoma; Nebraska status) |
| `licenseSubtype` | Extra licence detail the register publishes: specialty codes, monetary / bid limit, class type, sales-tax option ... |
| `rank`, `specialQualifications` | Florida rank and special qualifications; NYS registry compliance flags |
| `personnel` | People on the licence (Arizona personnel, Mississippi officers, Massachusetts contacts) |
| `businessId` | State business id where published (Washington UBI, NYC business id, Arkansas record id) |
| `website`, `websiteVerifiedBy`, `websiteFoundBy`, `additionalEmails`, `emailConfidence`, `emailMxVerified`, `enrichmentStatus` | With `enrichWebsiteEmail` |
| `sourceRegister`, `sourceUrl`, `scrapedAt` | Which register, a link to the record or the register's search, when read |

The dataset has three views: **Leads** (contact columns first), **Licence detail** and **Bond & insurance**.

### Pricing

Pay-per-event, the same price for every state:

| Apify plan | Per licence | Per 1,000 licences |
|---|---|---|
| Free, Starter, Scale | $0.001 | $1.00 |
| Business and higher | $0.0008 | $0.80 |

- charged once per distinct licence delivered to your dataset;
- **not** charged: rows your filters remove, duplicates, applicants without a licence number, and any request that failed;
- **optional add-on, only with `enrichWebsiteEmail` on: $0.0021 per licence delivered with a verified email from its website** ($2.10 per 1,000); rows without one, and emails the register itself publishes, cost nothing extra;
- no run-start fee;
- an empty-input run (`{}`) delivers at most 60 licences = $0.06 on the Free plan.

Set **Max licences** or the run's maximum charge to cap spend; a run that reaches its charge limit stops with whole, paid rows.

### Data limits

- **Phone**: Florida (DBPR), Connecticut (DCP) and Virginia (DPOR) publish none; Texas publishes none for A/C contractors; Ohio's roster carries a company phone on about two thirds of licences; Nebraska's phone is on the licence page (read with `fetchDetails`, on by default).
- **Current licences only** in the California, Arizona, Iowa, Arkansas, Oregon, Virginia, West Virginia, Nevada and Nebraska lists - `activeOnly: false` returns the same set there.
- **California**: no owner/qualifier name or bond amount (those are on CSLB's per-licence page behind a CAPTCHA). The largest slices are slow: CSLB builds its spreadsheet per request (Los Angeles x general building, ~23,000 licences, about a minute).
- **Florida**: construction and electrical licences share one renewal date per cycle, so an expiry window finds Florida rows only when it reaches that date.
- **Texas**: no status column (`isActive` = expiry today or later); plumbers are licensed by a different board (TSBPE), not covered.
- **Arizona**: county is not published (a county is matched through its ZIP codes); rows come newest licence first.
- **New York**: no statewide contractor licence. The NYS DOL Contractor Registry covers public-work contractors statewide; NYC DOB and DCWP licences cover New York City. NYC DOB rows carry no expiry date.
- **Massachusetts**: the home improvement registry only; statewide runs read newest registrations first.
- **Nevada**: its search filters on a licence's primary classification only.
- **Oregon**: CCB licenses by business scope (residential / commercial, general / specialty), so trades other than `general` do not apply.
- **Oklahoma**: roofing contractor registration only. **Wyoming**: electrical, limited-voltage and limited-mechanical contractors only; the portal notes that not every licensee is listed yet. **Ohio**: commercial trades only.
- Counts change daily as licences are issued, renewed and lapse.

### Run summary

Every run writes `RUN_SUMMARY` to its key-value store: per state, the register's own match count against licences delivered, each request with its size, rows filtered out and why, duplicates skipped, any request that failed after retries, and the transport totals. A run restarted by the platform resumes without delivering or charging any licence twice.

### FAQ

**Which states are covered?** The 22 in the table above. Other states either do not license contractors at state level, publish no list without a CAPTCHA or a fee, or publish only a lookup by name.

**Can I get only rows with a phone?** Yes - `requirePhone: true`.

**How fresh is the data?** Each run reads the live registers at run time; `scrapedAt` records when.

**Why did a state return nothing?** Check the status message: the trade may not be licensed by that state, none of your places may be in it, or no licence matched the filters. `RUN_SUMMARY` has the per-state detail.

**Found a problem or want another state?** Open an issue on the Issues tab.

# Actor input Schema

## `states` (type: `array`):

Which state registers to search (22). Leave the default for all of them. Connecticut, Florida, Virginia publish no phone number.

## `trades` (type: `array`):

Contractor trades, mapped to each state's own licence types (README table). A state that does not license a trade at state level is skipped for it, and the run says so. Leave empty (and Licence types empty) for every contractor licence type.

## `licenseTypes` (type: `array`):

Exact register codes, added to the trades above, as "STATE:code" - e.g. "CA:C-10" (CSLB class), "FL:0605" (DBPR type), "TX:Electrical Contractor", "AZ:CR-37" (ROC class), "WA:CC/CD" (L\&I type/specialty), "MN:BC", "VA:RBC". The README lists every state's codes.

## `counties` (type: `array`):

County names, e.g. "Los Angeles", "Maricopa", "King", "Hennepin". A name found in two selected states (Orange is in CA and FL) searches both; write "Orange, FL" or "FL:Orange" to pick one. Where a register publishes no county, the county's ZIP codes are used. Leave counties, cities and ZIPs empty to search statewide.

## `cities` (type: `array`):

City names, e.g. "San Diego", "Phoenix", "Spokane". Add ", CA" / ", AZ" (a state code) to limit a city to one state. Rows matching ANY listed county, city or ZIP are returned.

## `zipCodes` (type: `array`):

5-digit ZIP codes, e.g. "92101", "85004", "98101". Each ZIP is searched only in the state it belongs to.

## `activeOnly` (type: `boolean`):

Keep only licences the register shows as active (or, where it publishes no status column, whose expiry is today or later). Several registers list current licences only - the README says which.

## `expiringWithinDays` (type: `integer`):

Only licences whose expiry date falls between today and this many days from today - the renewal-window list. Registers that publish no expiry date return nothing with this on. 0 = off.

## `requirePhone` (type: `boolean`):

Drop rows the register publishes no phone for. Connecticut, Florida, Virginia publish none, so they are skipped with this on.

## `fetchDetails` (type: `boolean`):

Florida, Arizona, Mississippi and Nebraska keep part of the record on a per-licence page (Florida: qualifier + DBA; Arizona: bond, entity type, personnel; Mississippi: expiry, county, classes; Nebraska: PHONE and email). One extra small request per row in those states. Off = list fields only.

## `enrichWebsiteEmail` (type: `boolean`):

Most registers publish no email or website. With this on, the actor looks for the business's own website from its name and keeps it ONLY when the site shows the licence number or the register's phone, then reads the email(s) on that site. A verified email is charged as an add-on per row that gets one; rows without one cost nothing extra. Rows whose register already publishes an email keep it and are not searched or charged.

## `websiteDiscovery` (type: `string`):

How to look for the website when "Find website + email" is on. domain-guess (default): try the .com names the business name spells - fast and cheap. both: guess first, then one web search when the guess finds nothing (finds more, several times slower). search: web search only. Every found site must still show the licence number or register phone.

## `maxItems` (type: `integer`):

Stop after this many licences in total, shared across the states (a state with fewer matches hands its share to the others). You are charged per licence delivered. 0 = no limit.

## `proxyConfiguration` (type: `object`):

Not needed: every register answered direct requests when measured (Arizona's file host is reached through Apify's datacenter proxy automatically). If set, it is used only as a fallback after two failed direct attempts on a request.

## Actor input object example

```json
{
  "states": [
    "CA",
    "TX",
    "WA"
  ],
  "trades": [
    "electrical"
  ],
  "activeOnly": true,
  "expiringWithinDays": 0,
  "requirePhone": false,
  "fetchDetails": true,
  "enrichWebsiteEmail": false,
  "websiteDiscovery": "domain-guess",
  "maxItems": 30
}
```

# Actor output Schema

## `items` (type: `string`):

One row per licence from 22 state contractor registers, deduplicated on the register's own licence number: state, licence number and type, trades, status, expiry, business, owner/qualifier, phone, email where the register publishes it, address and county, plus bond, insurance and personnel where the register has them.

## `runSummary` (type: `string`):

RUN_SUMMARY: per state, the register's own match count vs licences delivered, every request slice, rows filtered and why, duplicates skipped, failed requests, and the billing reconciliation.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "states": [
        "CA",
        "TX",
        "WA"
    ],
    "trades": [
        "electrical"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/contractor-license-leads-email-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "states": [
        "CA",
        "TX",
        "WA",
    ],
    "trades": ["electrical"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/contractor-license-leads-email-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "states": [
    "CA",
    "TX",
    "WA"
  ],
  "trades": [
    "electrical"
  ],
  "maxItems": 30
}' |
apify call scrapersdelight/contractor-license-leads-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/contractor-license-leads-email-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/opJ9m1W9zpcjpcCED/builds/nUsUVyyXedG6ZrOyw/openapi.json
