# California CSLB Contractor Scraper (`scrapers_lat/california-cslb-scraper`) Actor
Extract licensed California contractor records from the CSLB public data portal by classification and county. Scrape license number, business name, status, classifications, issue and expiry dates, bond and workers comp, address, county, ZIP and phone for each contractor.
- **URL**: https://apify.com/scrapers\_lat/california-cslb-scraper.md
- **Developed by:** [Michael Flores](https://apify.com/scrapers_lat) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $8.00 / 1,000 results
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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## California CSLB Contractor Scraper
> Extract licensed California contractor records from the CSLB public data portal, covering every active and inactive license across all 58 California counties and 78 trade classifications.
18 fields per record
58 counties California coverage
JSON / CSV / Excel output formats
Updated 2026-06-22
### What you get
Each record is a licensed California contractor pulled straight from the Contractors State License Board public data portal, ready to load into a CRM, spreadsheet, or lead pipeline:
- **businessName**: registered business or owner name on the license
- **licenseNumber**: CSLB contractor license number
- **status**: license status (CLEAR, ACTIVE, EXPIRED, SUSPENDED, and similar)
- **url**: direct link to the CSLB license detail page
- **businessType**: entity type (Sole Owner, Corporation, Partnership, Limited Liability)
- **classifications**: list of trade classifications held (for example C-10, C-36, B)
- **issueDate**: date the license was originally issued
- **expireDate**: date the license expires
- **address**: business mailing address
- **city**: business city
- **state**: business state
- **zip**: business ZIP code
- **county**: California county the license is registered in
- **phone**: business telephone number
- **bondInfo\***: contractor's bond surety company, bond number, and effective date
- **workersComp\***: workers' compensation coverage type plus insurer, policy number, and effective and expiration dates when the contractor carries a policy
- **observedAt**: when this record was last seen by the scraper
- **error**: populated only if a download fails, otherwise null
*\*These fields only appear when Include Bond and Workers' Compensation Details is enabled.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Lead generation | Suppliers and service providers prospecting licensed contractors |
| Market research | Analysts mapping contractor density by county and trade |
| Compliance checks | Teams verifying license status, bond, and workers' comp coverage |
| Recruiting | Staffing firms sourcing licensed trades in specific regions |
| Data pipelines | Developers feeding CRMs and BI tools with construction data |
### Frequently Asked Questions
**How do I pull every electrician in Los Angeles County?**
Select classification C-10 Electrical and county Los Angeles, then run the actor. It downloads the full CSLB export for that combination and returns one record per contractor. You can select up to 10 classifications and 10 counties per run.
**Does it include the contractor's bond and workers' compensation details?**
Yes. With Include Bond and Workers' Compensation Details enabled, each record carries the surety company and bond number plus the workers' comp coverage type. Contractors who are exempt or self-insured are labeled accordingly instead of showing an insurer.
**Can I get contractors across several counties at once?**
Yes. Add multiple counties to the Counties field and the export covers all of them in a single run. Use Max Items to cap how many records you collect.
**Are email addresses included?**
No. The CSLB does not release contractor email addresses under California Business and Professions Code Section 27, so they are not part of the data and are never invented.
**What does the status field tell me?**
It reflects the current standing of the license as recorded by the CSLB, such as CLEAR for a license in good standing, or EXPIRED and SUSPENDED for licenses that are not currently valid.
---
> This actor is an independent tool and has no affiliation with the California Contractors State License Board or the State of California. It only accesses data that is published on the CSLB public data portal. Use it in accordance with the CSLB website terms.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of contractor records to collect across all selected classifications and counties. Optional.
## `withDetails` (type: `boolean`):
When enabled, each record also includes the contractor's bond information (surety company, bond number, effective date) and workers' compensation insurance (insurer, policy number, effective and expiration dates) parsed from the CSLB data export. When disabled, only the core license fields are emitted.
## `classifications` (type: `array`):
One or more CSLB license classifications to include in the download (for example C-10 Electrical, C-36 Plumbing, B General Building). At least one classification is required. The CSLB data portal accepts up to 10 classifications per request.
## `counties` (type: `array`):
One or more California counties to include in the download. At least one county is required. The CSLB data portal accepts up to 10 counties per request.
## `proxyConfiguration` (type: `object`):
Optional proxy. The CSLB public data portal is reachable directly without a proxy; enable a US Apify proxy only if requests start failing.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"classifications": [
"C-39"
],
"counties": [
"1"
],
"proxyConfiguration": {
"useApifyProxy": false
}
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"classifications": [
"C-39"
],
"counties": [
"1"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/california-cslb-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"classifications": ["C-39"],
"counties": ["1"],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/california-cslb-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"classifications": [
"C-39"
],
"counties": [
"1"
]
}' |
apify call scrapers_lat/california-cslb-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/california-cslb-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "California CSLB Contractor Scraper",
"description": "Extract licensed California contractor records from the CSLB public data portal by classification and county. Scrape license number, business name, status, classifications, issue and expiry dates, bond and workers comp, address, county, ZIP and phone for each contractor.",
"version": "0.1",
"x-build-id": "RIRW6uERD3RKD3ELW"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~california-cslb-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-california-cslb-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~california-cslb-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-california-cslb-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~california-cslb-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-california-cslb-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"classifications",
"counties"
],
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of contractor records to collect across all selected classifications and counties. Optional."
},
"withDetails": {
"title": "Include Bond and Workers' Compensation Details",
"type": "boolean",
"description": "When enabled, each record also includes the contractor's bond information (surety company, bond number, effective date) and workers' compensation insurance (insurer, policy number, effective and expiration dates) parsed from the CSLB data export. When disabled, only the core license fields are emitted.",
"default": true
},
"classifications": {
"title": "License Classifications",
"uniqueItems": true,
"type": "array",
"description": "One or more CSLB license classifications to include in the download (for example C-10 Electrical, C-36 Plumbing, B General Building). At least one classification is required. The CSLB data portal accepts up to 10 classifications per request.",
"items": {
"type": "string",
"enum": [
"A",
"B",
"B-2",
"C-2",
"C-4",
"C-5",
"C-6",
"C-7",
"C-8",
"C-9",
"C-10",
"C-11",
"C-12",
"C-13",
"C-15",
"C-16",
"C-17",
"C-20",
"C-21",
"C-22",
"C-23",
"C-27",
"C-28",
"C-29",
"C-31",
"C-32",
"C-33",
"C-34",
"C-35",
"C-36",
"C-38",
"C-39",
"C-42",
"C-43",
"C-45",
"C-46",
"C-47",
"C-49",
"C-50",
"C-51",
"C-53",
"C-54",
"C-55",
"C-57",
"C-60",
"C-61",
"C-61/D-3",
"C-61/D-4",
"C-61/D-6",
"C-61/D-9",
"C-61/D-10",
"C-61/D-12",
"C-61/D-16",
"C-61/D-21",
"C-61/D-24",
"C-61/D-28",
"C-61/D-29",
"C-61/D-30",
"C-61/D-31",
"C-61/D-34",
"C-61/D-35",
"C-61/D-38",
"C-61/D-39",
"C-61/D-40",
"C-61/D-41",
"C-61/D-42",
"C-61/D-49",
"C-61/D-50",
"C-61/D-52",
"C-61/D-53",
"C-61/D-56",
"C-61/D-59",
"C-61/D-62",
"C-61/D-63",
"C-61/D-64",
"C-61/D-65",
"ASB",
"HAZ"
],
"enumTitles": [
"A - General Engineering Contractor",
"B - General Building Contractor",
"B-2 – Residential Remodeling Contractor",
"C-2 - Insulation and Acoustical Contractor",
"C-4 - Boiler, Hot Water Heating and Steam Fitting Contractor",
"C-5 - Framing and Rough Carpentry Contractor",
"C-6 - Cabinet, Millwork and Finish Carpentry Contractor",
"C-7 - Low Voltage Systems Contractor",
"C-8 - Concrete Contractor",
"C-9 - Drywall Contractor",
"C-10 - Electrical Contractor",
"C-11 - Elevator Contractor",
"C-12 - Earthwork and Paving Contractors",
"C-13 - Fencing Contractor",
"C-15 - Flooring and Floor Covering Contractors",
"C-16 - Fire Protection Contractor",
"C-17 - Glazing Contractor",
"C-20 - Warm-Air Heating, Ventilating and Air-Conditioning Contractor",
"C-21 - Building Moving/Demolition Contractor",
"C-22 - Asbestos Abatement Contractor",
"C-23 - Ornamental Metal Contractor",
"C-27 - Landscaping Contractor",
"C-28 - Lock and Security Equipment Contractor",
"C-29 - Masonry Contractor",
"C-31 - Construction Zone Traffic Control Contractor",
"C-32 - Parking and Highway Improvement Contractor",
"C-33 - Painting and Decorating Contractor",
"C-34 - Pipeline Contractor",
"C-35 - Lathing and Plastering Contractor",
"C-36 - Plumbing Contractor",
"C-38 - Refrigeration Contractor",
"C-39 - Roofing Contractor",
"C-42 - Sanitation System Contractor",
"C-43 - Sheet Metal Contractor",
"C-45 - Sign Contractor",
"C-46 - Solar Contractor",
"C-47 - General Manufactured Housing Contractor",
"C-49 - Tree and Palm Contractor",
"C-50 - Reinforcing Steel Contractor",
"C-51 - Structural Steel Contractor",
"C-53 - Swimming Pool Contractor",
"C-54 - Ceramic and Mosaic Tile Contractor",
"C-55 - Water Conditioning Contractor",
"C-57 - Well Drilling Contractor",
"C-60 - Welding Contractor",
"C-61 - Limited Specialty Classification",
"C-61/D-3 - Awnings Contractor",
"C-61/D-4 - Central Vacuum Systems Contractor",
"C-61/D-6 - Concrete-Related Services Contractor",
"C-61/D-9 - Drilling, Blasting and Oil Field Work Contractor",
"C-61/D-10 - Elevated Floors Contractor",
"C-61/D-12 - Synthetic Products Contractor",
"C-61/D-16 - Hardware, Locks and Safes Contractor",
"C-61/D-21 - Machinery and Pumps Contractor",
"C-61/D-24 - Metal Products Contractor",
"C-61/D-28 - Doors, Gates and Activating Devices Contractor",
"C-61/D-29 - Paperhanging Contractor",
"C-61/D-30 - Pile Driving and Pressure Foundation Jacking Contractor",
"C-61/D-31 - Pole Installation and Maintenance Contractor",
"C-61/D-34 - Prefabricated Equipment Contractor",
"C-61/D-35 - Pool and Spa Maintenance Contractor",
"C-61/D-38 - Sand and Water Blasting Contractor",
"C-61/D-39 - Scaffolding Contractor",
"C-61/D-40 - Service Station Equipment and Maintenance Contractor",
"C-61/D-41 - Siding and Decking Contractor",
"C-61/D-42 - Non-Electrical Sign Installation",
"C-61/D-49 - Tree Service Contractor",
"C-61/D-50 - Suspended Ceilings Contractor",
"C-61/D-52 - Window Coverings Contractor",
"C-61/D-53 - Wood Tanks Contractor",
"C-61/D-56 - Trenching Only Contractor",
"C-61/D-59 - Hydroseed Spraying Contractor",
"C-61/D-62 - Air and Water Balancing Contractor",
"C-61/D-63 - Construction Clean-up Contractor",
"C-61/D-64 - Non-specialized Contractor",
"C-61/D-65 - Weatherization and Energy Conservation Contractor",
"ASB - Asbestos Certification",
"HAZ - Hazardous Substance Removal Certification"
]
}
},
"counties": {
"title": "Counties",
"uniqueItems": true,
"type": "array",
"description": "One or more California counties to include in the download. At least one county is required. The CSLB data portal accepts up to 10 counties per request.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32",
"33",
"34",
"35",
"36",
"37",
"38",
"39",
"40",
"41",
"42",
"43",
"44",
"45",
"46",
"47",
"48",
"49",
"50",
"51",
"52",
"53",
"54",
"55",
"56",
"57",
"58"
],
"enumTitles": [
"Alameda",
"Alpine",
"Amador",
"Butte",
"Calaveras",
"Colusa",
"Contra Costa",
"Del Norte",
"El Dorado",
"Fresno",
"Glenn",
"Humboldt",
"Imperial",
"Inyo",
"Kern",
"Kings",
"Lake",
"Lassen",
"Los Angeles",
"Madera",
"Marin",
"Mariposa",
"Mendocino",
"Merced",
"Modoc",
"Mono",
"Monterey",
"Napa",
"Nevada",
"Orange",
"Placer",
"Plumas",
"Riverside",
"Sacramento",
"San Benito",
"San Bernardino",
"San Diego",
"San Francisco",
"San Joaquin",
"San Luis Obispo",
"San Mateo",
"Santa Barbara",
"Santa Clara",
"Santa Cruz",
"Shasta",
"Sierra",
"Siskiyou",
"Solano",
"Sonoma",
"Stanislaus",
"Sutter",
"Tehama",
"Trinity",
"Tulare",
"Tuolumne",
"Ventura",
"Yolo",
"Yuba"
]
}
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Optional proxy. The CSLB public data portal is reachable directly without a proxy; enable a US Apify proxy only if requests start failing.",
"default": {
"useApifyProxy": false
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```