# Us Contractor License Feed (`jamkon/us-contractor-license-feed`) Actor Get newly licensed contractors in Florida and Texas as a scheduled feed (electricians, HVAC, roofing, plumbing, general building and more), plus batch license verification. Built on official state data - no scraping, no personal contact info. - **URL**: https://apify.com/jamkon/us-contractor-license-feed.md - **Developed by:** [james correy](https://apify.com/jamkon) (community) - **Categories:** Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 per new records This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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 Feed + Verification - FL & TX (DBPR, TDLR) Know **the moment a new contractor gets licensed** in Florida or Texas — electricians, HVAC contractors, roofers, plumbers, general building contractors and more — and **verify license numbers in bulk** against the freshest official data. Built entirely on **official state bulk data** (Florida DBPR license extracts and the Texas TDLR dataset on the official Texas Open Data Portal). No scraping, no fragile page automation — which means this feed doesn't break when a website changes. ### Who uses this - **Suppliers, distributors, insurers, and SaaS vendors**: newly licensed contractors are brand-new businesses actively buying tools, materials, insurance, software, and services. Reach them in their first weeks, before your competitors know they exist. - **Compliance and marketplace teams**: batch-verify that contractor license numbers are current before onboarding or paying them. - **Lead-gen agencies**: a scheduled, deduplicated feed of new trade businesses by state, trade and location. ### Two modes #### 1. New-license feed (delta) Run it on a schedule (daily or weekly). Each run compares the current official data against the previous run and emits **only what changed**: - `new_license` — a license number that wasn't there before - `status_changed` — status or expiry changed (Florida) The **first delta run builds the baseline and emits nothing** — that's by design, there is nothing to compare against yet. Events flow from the second run onward. (Want to see output on your very first run? The actor's default input runs **verification mode** with a sample license, so a run with no changes returns a real result straight away — then switch to delta for the feed.) ```json { "eventType": "new_license", "state": "FL", "licenseNumber": "CBC123456", "businessName": "SUNSHINE BUILD GROUP LLC", "rawLicenseType": "CBC", "normalizedTrade": "general_building", "status": "C", "issueDate": "06/28/2026", "expiryDate": "08/31/2028", "city": "TAMPA", "zip": "33602" } ```` Filter by state, normalised trade, county (TX) or city (FL). Optionally POST each run's events to your webhook for Zapier/Make/n8n pipelines. #### 2. Batch verification Give it a list of license numbers; get back each one's current status from the freshest official file — licensed or not found — in one run. No per-lookup page automation, so verifying 1,000 numbers is as reliable as verifying one. ### Coverage | State | Source | Trades | |---|---|---| | Florida | DBPR construction-industry license extract (updated weekly by the state) | General building, residential, roofing, HVAC, plumbing, electrical\*, pool, solar, mechanical, underground utility, specialty | | Texas | TDLR licenses via the official Texas Open Data Portal | Electrical (all tiers), HVAC, appliance installation, water well, elevator, sign electricians | \*Florida electrical contractors are licensed by a separate board; coverage here follows the DBPR construction file. Ask via Issues if you need another board or state — the roadmap is driven by requests. ### What this actor never collects Official license records can include personal home addresses and owner details. This actor **emits business-identity fields only**: business/licensee name as officially registered, license numbers, types, statuses, dates, city/county/zip. No street addresses, no phone numbers, no emails. ### Pricing Pay per event: a small actor-start fee, then per new-license event, per status-change event, or per license verified. A weekly schedule tracking a single trade in one state typically costs a few dollars a month. No subscription. ### Notes - "Not found" in verify mode means the number isn't in the current official extract for the states and license types in scope — always check the scope before treating a contractor as unlicensed. - Texas data includes active licenses only, so Texas emits `new_license` events (no status changes). - Found a problem or need another state? Open an issue — replies are fast, usually same day. # Actor input Schema ## `mode` (type: `string`): "verify": check the current status of specific license numbers (returns a row per number, always). "delta": emit newly licensed contractors and status changes since the previous run — schedule it daily/weekly (the first run builds a baseline and emits nothing; new licenses flow from the next run). Switch to delta and add the states/trades you want for the lead feed. ## `states` (type: `array`): Which states to include. FL covers the DBPR construction industry file (all contractor boards); TX covers TDLR trade licenses (electrical, HVAC and more). ## `trades` (type: `array`): Only emit these normalised trades. Leave empty for all trades. ## `counties` (type: `array`): Only emit records in these counties (Texas records carry county names, e.g. "TRAVIS"). Leave empty for all. ## `cities` (type: `array`): Only emit records in these cities (Florida records carry city names, e.g. "MIAMI"). Leave empty for all. ## `txLicenseTypes` (type: `array`): TDLR license types to track. In the delta feed, add the trades you want (electrical, HVAC, etc.). Prefilled with one type for a fast example run. ## `licenseNumbers` (type: `array`): License numbers to verify, e.g. "CBC015061" (FL) or "11484" (TX). Used only in verify mode. ## `webhookUrl` (type: `string`): If set, delta runs POST the emitted events to this URL as JSON (in addition to the dataset). ## Actor input object example ```json { "mode": "verify", "states": [ "tx" ], "trades": [], "counties": [], "cities": [], "txLicenseTypes": [ "Elevator Contractor" ], "licenseNumbers": [ "20002" ] } ``` # 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": [ "tx" ], "txLicenseTypes": [ "Elevator Contractor" ], "licenseNumbers": [ "20002" ] }; // Run the Actor and wait for it to finish const run = await client.actor("jamkon/us-contractor-license-feed").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": ["tx"], "txLicenseTypes": ["Elevator Contractor"], "licenseNumbers": ["20002"], } # Run the Actor and wait for it to finish run = client.actor("jamkon/us-contractor-license-feed").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": [ "tx" ], "txLicenseTypes": [ "Elevator Contractor" ], "licenseNumbers": [ "20002" ] }' | apify call jamkon/us-contractor-license-feed --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jamkon/us-contractor-license-feed", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Us Contractor License Feed", "description": "Get newly licensed contractors in Florida and Texas as a scheduled feed (electricians, HVAC, roofing, plumbing, general building and more), plus batch license verification. Built on official state data - no scraping, no personal contact info.", "version": "1.0", "x-build-id": "YWWcbnt5tidnk3ZG8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jamkon~us-contractor-license-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jamkon-us-contractor-license-feed", "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/jamkon~us-contractor-license-feed/runs": { "post": { "operationId": "runs-sync-jamkon-us-contractor-license-feed", "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/jamkon~us-contractor-license-feed/run-sync": { "post": { "operationId": "run-sync-jamkon-us-contractor-license-feed", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "verify", "delta" ], "type": "string", "description": "\"verify\": check the current status of specific license numbers (returns a row per number, always). \"delta\": emit newly licensed contractors and status changes since the previous run — schedule it daily/weekly (the first run builds a baseline and emits nothing; new licenses flow from the next run). Switch to delta and add the states/trades you want for the lead feed.", "default": "verify" }, "states": { "title": "States", "type": "array", "description": "Which states to include. FL covers the DBPR construction industry file (all contractor boards); TX covers TDLR trade licenses (electrical, HVAC and more).", "items": { "type": "string", "enum": [ "fl", "tx" ], "enumTitles": [ "Florida (DBPR)", "Texas (TDLR)" ] }, "default": [ "tx" ] }, "trades": { "title": "Trades filter", "type": "array", "description": "Only emit these normalised trades. Leave empty for all trades.", "items": { "type": "string", "enum": [ "general_building", "residential", "roofing", "hvac", "plumbing", "electrical", "pool", "underground_utility", "solar", "sheet_metal", "mechanical", "appliance", "water_well", "elevator", "sign", "specialty", "other" ] }, "default": [] }, "counties": { "title": "Counties filter (TX)", "type": "array", "description": "Only emit records in these counties (Texas records carry county names, e.g. \"TRAVIS\"). Leave empty for all.", "default": [], "items": { "type": "string" } }, "cities": { "title": "Cities filter (FL)", "type": "array", "description": "Only emit records in these cities (Florida records carry city names, e.g. \"MIAMI\"). Leave empty for all.", "default": [], "items": { "type": "string" } }, "txLicenseTypes": { "title": "Texas license types", "type": "array", "description": "TDLR license types to track. In the delta feed, add the trades you want (electrical, HVAC, etc.). Prefilled with one type for a fast example run.", "default": [ "A/C Contractor", "A/C Technician", "Electrical Contractor", "Master Electrician", "Journeyman Electrician", "Residential Wireman", "Maintenance Electrician", "Journeyman Industrial Electrician", "Electrical Sign Contractor", "Master Sign Electrician", "Appliance Installation Contractor", "Appliance Installer", "Water Well Driller/Pump Installer", "Elevator Contractor" ], "items": { "type": "string" } }, "licenseNumbers": { "title": "License numbers (verify mode)", "type": "array", "description": "License numbers to verify, e.g. \"CBC015061\" (FL) or \"11484\" (TX). Used only in verify mode.", "default": [ "20002" ], "items": { "type": "string" } }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "If set, delta runs POST the emitted events to this URL as JSON (in addition to the dataset)." } } }, "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 } } } } } } } } } } ```