California CSLB Contractor License Records Scraper — Bulk Lookup & Verification

Extract official California contractor license records — general building (B), engineering (A), electrical (C10), plumbing (C36), HVAC (C20), roofing (C39), painting (C33), landscaping (C27), and every other CSLB classification — straight from the Contractors State License Board's public Master List (~243,000 licenses). Filter by classification, county, city, ZIP, status, business type, and expiration date and download clean JSON, CSV, or Excel.

Because this Actor reads CSLB's official statewide master file (not a fragile one-at-a-time search form), it is fast, complete, and does not miss records — and every record includes the business phone number, contractor bond, and workers' comp details that CSLB publishes.

What data do you get?

One result per license record:

Field	Example
licenseNumber	1000002
businessName / fullBusinessName	DOCKERY RANDALL MARK
businessType	Sole Owner / Corporation / Limited Liability
addressLine1, city, state, zip, county	Mailing address of record
phone	(925) 383 0487
primaryStatus / secondaryStatus	CLEAR (in good standing) or suspension flags
classifications	A, B, C10
issueDate / expirationDate	2015-01-10 / 2027-01-31
workersCompCoverageType, wcInsuranceCompany, wcExpirationDate	Workers' comp coverage
contractorBondCompany, contractorBondNumber, contractorBondAmount	Contractor bond

Use cases

• Lead generation — build county- or city-level lists of active contractors with phone numbers for insurance, building materials, SaaS, CE courses, or financial products. Combine with expiresBefore to target contractors whose renewal is coming up.
• License verification at scale — verify that subcontractors, vendors, or marketplace signups hold a CLEAR California license with active workers' comp.
• Insurance & lending — underwriting checks: license status, bond amount, workers' comp coverage type and insurer in one record.
• Compliance & risk — flag partners whose license is suspended (bond, workers' comp, judgement suspensions) or expiring; the suspended status filter returns exactly the flagged population.
• Market sizing & analytics — count C10 electricians per county, track new licensees, analyze contractor density.

How to use it

{
    "classifications": ["B"],
    "counties": ["Los Angeles"],
    "status": "clear",
    "expiresBefore": "2026-12-31",
    "maxResults": 5000
}

Leave classifications, counties, cities, and zips empty for statewide, all-classification pulls. maxResults caps the run — you are only charged for records actually returned.

Pricing

Pay per result: one charge per license record extracted — $4.00 per 1,000 records ($0.004/record). A 1,000-lead county list with phone numbers costs $4 versus hours of manual CSLB searching.

Data source & freshness

Records come from the CSLB Public Data Portal's Master List of California Licensed Contractors (cslb.ca.gov), which CSLB refreshes weekly. This is public information published by the State of California. The master list contains licenses that are currently renewed or expired-but-renewable; cancelled, revoked, and expired non-renewable licenses are excluded by CSLB at the source. Email addresses are not published by CSLB (B&P Code Section 27) — no actor can legitimately provide them.

Reliability

Whale-sized pulls are safe by design: the ~78 MB master file is processed as a stream (memory-safe at any maxResults), downloads retry automatically across proxy tiers if CSLB's CDN cuts or blocks a connection, and progress is checkpointed so a platform restart never double-charges or drops records.

FAQ

How current is the data? CSLB regenerates the master list weekly (the run log shows the streaming source). Schedule the Actor weekly to keep your lists fresh.

Can I pull all ~243,000 licenses? Yes — leave the filters empty, set maxResults to 250000, and let it stream. A full statewide scan takes several minutes because CSLB serves the file slowly; filtered county/classification pulls that hit maxResults early finish much faster.

What does primaryStatus: CLEAR mean? In good standing. Suspension-type statuses (contractor bond suspension, workers' comp suspension, judgement suspension...) are included when you set status to any or suspended.

Do you have the qualifier/personnel names or workers' comp history? CSLB publishes separate Personnel and Workers' Compensation files; support is on the roadmap — open an issue on the Actor's Issues tab if you need them.