# New Contractor License Leads 🛠️ (CA, FL, TX) (`tagadanar/contractor-license-leads`) Actor
Fresh contractor leads from the official state license registries: newly issued CA CSLB, FL DBPR and TX TDLR licenses, normalized with business name, phone, address and classification. Schedule it and get only the new licensees since your last run.
- **URL**: https://apify.com/tagadanar/contractor-license-leads.md
- **Developed by:** [Tagada Data](https://apify.com/tagadanar) (community)
- **Categories:** Lead generation, Automation, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $56.00 / 1,000 new license leads
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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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
## New Contractor License Leads: CA, FL & TX Official Registries
**Get the contractors who were licensed this week, before your competitors even know they exist.** This actor scans the official state license registries (California CSLB, Florida DBPR, Texas TDLR) and returns newly issued contractor licenses as normalized, ready-to-call leads: business name, owner, phone, address, classification and issue date, in one cross-state schema.
Built for **insurance agents and bonding agencies, building-material and tool suppliers, software and service vendors selling to trades, and lead-gen teams** who know that a brand-new licensee needs insurance, bonds, accounts and suppliers right now. Retail lead brokers charge $20 and more per shared contractor lead; here you pull them straight from the source registries for cents.
### Why this actor
- The freshness IS the product: everyone can look up a license; this delivers the *new* ones. Set a date window (licenses issued in the last 7 or 30 days) or schedule it in delta mode and receive only licensees that appeared since your last run.
- Official sources only: CSLB master file, DBPR licensee extracts and the TDLR registry on the Texas Open Data Portal, all published by the states themselves and refreshed daily. No scraping walls, no stale resold lists.
- One schema across states: license number, business name, owner, phone, address, city, ZIP, county, classifications, issue date, expiration and status, identical columns whether the lead is from CA, FL or TX.
- Classification filter that speaks contractor: "C-10", "CGC" or "Electrical Contractor" all work, so an insurance program targeting roofers only pays for roofers.
- Built for schedules: delta mode remembers what it already reported, prunes itself, and never bills the Texas baseline run (the first Texas delta run records the registry and returns nothing, honestly).
- Direct to your stack: dataset, API, or pipe it into your CRM enrichment flow like any Apify dataset.
### Use cases
- **Insurance and bonding**: every new CSLB or DBPR licensee needs general liability and often a bond within days of issuance. Be the first call.
- **Building material and tool suppliers**: open trade accounts with new contractors in your territory.
- **SaaS for trades**: new electrical contractors in Texas are prospects for estimating, invoicing and dispatch software.
- **Lead resellers**: normalized, deduplicated, source-attributed records at registry cost.
- **AI agents**: plug it into Claude, Cursor or any MCP client and ask, *"which roofing contractors got licensed in Florida this month?"*
### Input
```json
{
"states": ["CA", "FL"],
"licenseClassifications": ["Roofing"],
"issuedWithinDays": 30,
"maxItems": 100
}
````
For scheduled monitoring, switch to delta mode (required for Texas, which publishes no issue dates):
```json
{
"states": ["CA", "FL", "TX"],
"deltaMode": true,
"maxItems": 500
}
```
### Output
```json
{
"state": "CA",
"licenseNumber": "1157281",
"businessName": "PROFESSIONAL ROOFING",
"ownerName": null,
"phone": "(805) 944-6604",
"address": "123 MAIN ST",
"city": "LANCASTER",
"zip": "93534",
"county": "Los Angeles",
"classifications": ["C39"],
"licenseType": "Sole Owner",
"issueDate": "2026-06-26",
"expirationDate": "2028-06-30",
"status": "Active",
"source": "CA Contractors State License Board (CSLB)",
"sourceUrl": "https://www.cslb.ca.gov/onlineservices/checklicenseII/licensedetail.aspx?LicNum=1157281"
}
```
### Pricing
You pay per lead actually delivered, plus a small run start fee. That is the whole price: compute, downloads and proxies are included, so a run's cost is predictable before you start it. A quiet scheduled run that finds nothing new costs one cent; 100 fresh licensees cost a few dollars, against $20+ each from retail lead brokers.
### FAQ
**Where exactly does the data come from?** The CSLB public data portal master file (California), the DBPR licensee file extracts for the construction and electrical boards (Florida), and the TDLR "All Licenses" dataset on data.texas.gov (Texas). All three are official, public and updated daily by the agencies.
**Why does Texas behave differently?** TDLR does not publish license issue dates. So instead of a date window, Texas works in delta mode: the first run records the current registry as a baseline (free), and every following run reports licenses that newly appeared. CA and FL carry real issue dates and work both ways.
**Do Florida leads include phone numbers?** No, the DBPR bulk extracts do not publish phone numbers; FL rows carry name and address. CA and TX rows include phone where the registry publishes one.
**Which Florida licenses are covered?** The construction board (general, building, residential, roofing, plumbing, HVAC, pool, specialty and more) and the electrical contractors board. Course providers and financial-officer records are filtered out; only actual contractor licenses become leads.
**Is this personal data?** The records are business license registrations published by the states for public verification. You are responsible for using them in line with the laws that apply to your outreach (TCPA for calls and texts in the US, CAN-SPAM for email).
# Actor input Schema
## `states` (type: `array`):
Which state license registries to scan. California (CSLB) and Florida (DBPR) publish issue dates, so they work with the date window below. Texas (TDLR) publishes no issue dates: new Texas licenses are detected in delta mode (new since your last run).
## `licenseClassifications` (type: `array`):
Only return licenses matching these classification codes or names, e.g. C-10, CGC, Electrical Contractor, Roofing. Leave empty for all contractor licenses.
## `issuedWithinDays` (type: `integer`):
The lead window for CA and FL: only licenses issued within this many days are returned. Ignored when a start date is set below.
## `issuedSince` (type: `string`):
Alternative to the day window: an exact start date like 2026-07-01.
## `deltaMode` (type: `boolean`):
For scheduled runs: remember what has been reported and return only licenses that are new since the previous run. Required for Texas. The first delta run for Texas seeds a baseline and reports nothing; every later run reports only genuinely new licenses.
## `maxItems` (type: `integer`):
Stop after this many leads.
## Actor input object example
```json
{
"states": [
"CA"
],
"licenseClassifications": [],
"issuedWithinDays": 30,
"deltaMode": false,
"maxItems": 25
}
```
# Actor output Schema
## `leads` (type: `string`):
One row per newly issued contractor license.
# 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 = {
"states": [
"CA"
],
"licenseClassifications": [],
"issuedWithinDays": 30,
"maxItems": 25
};
// Run the Actor and wait for it to finish
const run = await client.actor("tagadanar/contractor-license-leads").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 = {
"states": ["CA"],
"licenseClassifications": [],
"issuedWithinDays": 30,
"maxItems": 25,
}
# Run the Actor and wait for it to finish
run = client.actor("tagadanar/contractor-license-leads").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 '{
"states": [
"CA"
],
"licenseClassifications": [],
"issuedWithinDays": 30,
"maxItems": 25
}' |
apify call tagadanar/contractor-license-leads --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=tagadanar/contractor-license-leads",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "New Contractor License Leads 🛠️ (CA, FL, TX)",
"description": "Fresh contractor leads from the official state license registries: newly issued CA CSLB, FL DBPR and TX TDLR licenses, normalized with business name, phone, address and classification. Schedule it and get only the new licensees since your last run.",
"version": "0.1",
"x-build-id": "kDwNQ5MGMrqudVrCj"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~contractor-license-leads/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-contractor-license-leads",
"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/tagadanar~contractor-license-leads/runs": {
"post": {
"operationId": "runs-sync-tagadanar-contractor-license-leads",
"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/tagadanar~contractor-license-leads/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-contractor-license-leads",
"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": [
"states"
],
"properties": {
"states": {
"title": "States to scan",
"minItems": 1,
"type": "array",
"description": "Which state license registries to scan. California (CSLB) and Florida (DBPR) publish issue dates, so they work with the date window below. Texas (TDLR) publishes no issue dates: new Texas licenses are detected in delta mode (new since your last run).",
"items": {
"type": "string",
"enum": [
"CA",
"FL",
"TX"
],
"enumTitles": [
"California (CSLB)",
"Florida (DBPR)",
"Texas (TDLR)"
]
},
"default": [
"CA",
"FL",
"TX"
]
},
"licenseClassifications": {
"title": "License classifications (optional filter)",
"type": "array",
"description": "Only return licenses matching these classification codes or names, e.g. C-10, CGC, Electrical Contractor, Roofing. Leave empty for all contractor licenses.",
"items": {
"type": "string"
}
},
"issuedWithinDays": {
"title": "Issued within the last N days",
"minimum": 1,
"maximum": 365,
"type": "integer",
"description": "The lead window for CA and FL: only licenses issued within this many days are returned. Ignored when a start date is set below.",
"default": 7
},
"issuedSince": {
"title": "Issued since (date)",
"type": "string",
"description": "Alternative to the day window: an exact start date like 2026-07-01."
},
"deltaMode": {
"title": "Delta mode (only new since last run)",
"type": "boolean",
"description": "For scheduled runs: remember what has been reported and return only licenses that are new since the previous run. Required for Texas. The first delta run for Texas seeds a baseline and reports nothing; every later run reports only genuinely new licenses.",
"default": false
},
"maxItems": {
"title": "Max leads per run",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Stop after this many leads.",
"default": 500
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```