USA Contractor License Scraper: Names, Phones & Addresses

Here is one real result, with every field the actor returns:

{
  "businessName": "24/7 ROOFING INSTALLATION LLC",
  "primaryPrincipalName": "QUIROZ ARELLANO, SERGIO",
  "contractorLicenseNumber": "247RORI742C6",
  "contractorLicenseTypeCode": "CC",
  "contractorLicenseType": "CONSTRUCTION CONTRACTOR",
  "specialtyCode1": "01",
  "specialty1": "GENERAL",
  "specialtyCode2": null,
  "specialty2": null,
  "statusCode": "A",
  "status": "ACTIVE",
  "addressStreet": "3213 83RD ST S",
  "addressStreet2": "TRLR 14",
  "city": "LAKEWOOD",
  "state": "WA",
  "zip": "98499",
  "phone": "2064510653",
  "ubi": "606067689",
  "businessTypeCode": "L",
  "businessType": "Limited Liability Company",
  "effectiveDate": "2026-02-26",
  "expirationDate": "2028-02-26",
  "suspendDate": null,
  "insuranceCompany": "Maxum Indemnity Co",
  "insurancePolicyNumber": "BDG314177301",
  "insuranceAmount": 1000000,
  "insuranceEffectiveDate": "2026-02-25",
  "insuranceExpirationDate": "2027-02-25",
  "insuranceAgency": null,
  "bondCompany": "Travelers Cas Insurance Co of America",
  "bondNumber": "108445064",
  "bondAmount": 30000,
  "bondEffectiveDate": "2026-02-25",
  "bondExpirationDate": "Until Canceled",
  "searchQuery": "Roofing",
  "source": "US State Contractor License Register",
  "observedAt": "2026-08-10T14:31:49.865Z",
  "error": null
}

The most complete US contractor license scraper available. It returns every field the state contractor register exposes for each licensed contractor, including the principal contact, phone, full address, license type and specialty, and the filed liability insurance and surety bond details, and gives you four filters to target exactly the contractors you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor queries the public state contractor license register, applies the filters you pass as input, paginates through the matching contractors, and writes one normalized record per license to the run's dataset. For each contractor it also pulls the filed liability insurance and surety bond records and joins them onto the license, so a single row carries the business identity, contact details, license status and its coverage. Dates are normalized to YYYY-MM-DD, missing source values are returned as null, and numeric amounts (insuranceAmount, bondAmount) are returned as numbers.

Data covers the Washington State contractor register, which lists construction and specialty contractors licensed to work in the state. It is public data, so no account or API key is required.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the 10 most recent roofing contractors.

{
  "searchQueries": ["Roofing"],
  "maxLicenses": 10
}

Leave searchQueries empty to scan all licenses filtered by the other fields. Every input field is optional; with an empty input the actor pulls contractor licenses with no keyword filter (default maxLicenses is 10).

Input reference

Field	Type	Required	Default	Description
searchQueries	string[]	no	["Roofing"]	Business or principal / owner names to search for. One search runs per entry. Leave empty to scan all licenses. Example: ["Roofing", "Northwest Electric"].
cities	string[]	no	(empty)	Keep only licenses in these cities (exact city name). Case-insensitive. Example: ["Seattle", "Tacoma"].
licenseTypes	string[]	no	(empty)	Keep only these license types, by name (for example Construction Contractor, Specialty Contractor, General Contractor) or type code. Leave empty for all types.
status	string	no	(empty)	Keep only licenses whose status contains this text (for example Active, Expired, Suspended).
maxLicenses	integer	no	10	Maximum number of licenses to collect across the whole run. Minimum 1, maximum 1000000.

Filters combine with logical AND. If you pass no filters at all, the actor returns the most recent contractor licenses.

Output reference

One dataset item per contractor license. Types: string, number, or null when the source value is absent.

Field	Type	Description
businessName	string	Contractor business name.
primaryPrincipalName	string	Principal / owner contact on the license.
contractorLicenseNumber	string	Contractor license number.
contractorLicenseTypeCode	string	License type code.
contractorLicenseType	string	License type description.
specialtyCode1	string	Primary specialty code.
specialty1	string	Primary specialty / classification.
specialtyCode2	string	Secondary specialty code, or null.
specialty2	string	Secondary specialty / classification, or null.
statusCode	string	License status code.
status	string	License status (for example ACTIVE, EXPIRED, SUSPENDED).
addressStreet	string	Business street address.
addressStreet2	string	Business street address line 2, or null.
city	string	City.
state	string	State.
zip	string	ZIP code.
phone	string	Business phone number.
ubi	string	Unified Business Identifier.
businessTypeCode	string	Business type code.
businessType	string	Business type (LLC, corporation, sole proprietor and so on).
effectiveDate	string	License effective date (YYYY-MM-DD).
expirationDate	string	License expiration date (YYYY-MM-DD).
suspendDate	string	License suspension date, or null.
insuranceCompany	string	Liability insurance company.
insurancePolicyNumber	string	Insurance policy number.
insuranceAmount	number	Insurance coverage amount.
insuranceEffectiveDate	string	Insurance effective date (YYYY-MM-DD).
insuranceExpirationDate	string	Insurance expiration date (YYYY-MM-DD).
insuranceAgency	string	Insurance agency / broker on file, or null.
bondCompany	string	Surety / bond company.
bondNumber	string	Bond account / number.
bondAmount	number	Bond amount on file.
bondEffectiveDate	string	Bond effective date (YYYY-MM-DD).
bondExpirationDate	string	Bond expiration date, or the literal Until Canceled.
searchQuery	string	Search keyword that produced this record.
source	string	Data source.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"searchQueries": ["Roofing"], "maxLicenses": 10}):

{
  "businessName": "24/7 ROOFING INSTALLATION LLC",
  "primaryPrincipalName": "QUIROZ ARELLANO, SERGIO",
  "contractorLicenseNumber": "247RORI742C6",
  "contractorLicenseTypeCode": "CC",
  "contractorLicenseType": "CONSTRUCTION CONTRACTOR",
  "specialtyCode1": "01",
  "specialty1": "GENERAL",
  "specialtyCode2": null,
  "specialty2": null,
  "statusCode": "A",
  "status": "ACTIVE",
  "addressStreet": "3213 83RD ST S",
  "addressStreet2": "TRLR 14",
  "city": "LAKEWOOD",
  "state": "WA",
  "zip": "98499",
  "phone": "2064510653",
  "ubi": "606067689",
  "businessTypeCode": "L",
  "businessType": "Limited Liability Company",
  "effectiveDate": "2026-02-26",
  "expirationDate": "2028-02-26",
  "suspendDate": null,
  "insuranceCompany": "Maxum Indemnity Co",
  "insurancePolicyNumber": "BDG314177301",
  "insuranceAmount": 1000000,
  "insuranceEffectiveDate": "2026-02-25",
  "insuranceExpirationDate": "2027-02-25",
  "insuranceAgency": null,
  "bondCompany": "Travelers Cas Insurance Co of America",
  "bondNumber": "108445064",
  "bondAmount": 30000,
  "bondEffectiveDate": "2026-02-25",
  "bondExpirationDate": "Until Canceled",
  "searchQuery": "Roofing",
  "source": "US State Contractor License Register",
  "observedAt": "2026-08-10T14:31:49.865Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~usa-contractor-licenses-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["Roofing"],"cities":["Seattle"],"maxLicenses":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~usa-contractor-licenses-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"licenseTypes":["Construction Contractor"],"status":"Active","maxLicenses":100}'

Apify CLI:

apify call scrapers_lat/usa-contractor-licenses-scraper \
  --input '{"searchQueries":["Northwest Electric"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxLicenses.

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing in the source. Loosen filters (for example remove cities or status), or confirm the keyword appears in the business or principal name. Zero-result runs are not charged.

Which state does this cover? The Washington State contractor register, which lists construction and specialty contractors licensed to work in the state.

Do all records include insurance and bond details? The actor joins the filed liability insurance and surety bond records onto each license where they exist. When a contractor has no bond or insurance record on file, those fields are returned as null.

Why is bondExpirationDate a word instead of a date? Some surety bonds are filed as continuous with no fixed end, in which case the source records the literal Until Canceled. Real source values are never altered.

Can I search several names in one run? Yes. Pass multiple entries in searchQueries; one search runs per entry and all results are merged into the dataset.

Is this an official state tool? No. This actor is independent and has no affiliation with any state licensing agency. It reads only data that is publicly available. Use it in accordance with the source's terms of service.

Related scrapers

• US Business Licenses Scraper: US business licenses with names, addresses and license types.
• USA Medical License Scraper: US medical professional licenses and disciplinary status.
• USA Liquor License Scraper: US liquor and alcohol licenses.
• USA FCC License Scraper: FCC radio and wireless license grants.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with any state licensing agency. Accesses only publicly available data. Use in accordance with the source's terms of service.