# US Professional License Scraper - Licensed Pro Leads (`scrapesage/us-professional-license-scraper`) Actor

Scrape US professional & occupational licenses from official state boards (CO, CT, DE, TX): name, profession, license number, status, issue & expiration dates, location. Every regulated profession — nurses, contractors, real estate, CPAs & more. Filters + monitoring, no browser.

- **URL**: https://apify.com/scrapesage/us-professional-license-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 license records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## US Professional License Scraper — Licensed Professional Leads (All Professions, Official State Boards)

Extract **US professional & occupational license data** straight from the official state licensing boards — every regulated profession, in one actor. Get the **licensee name, profession, license number, status, issue & expiration dates, and mailing location** for millions of nurses, contractors, cosmetologists, real estate agents, CPAs, engineers, dentists, veterinarians, electricians, counselors, pharmacists, and more.

Built on official state **open-data portals** — no login, no API key, no browser, no anti-bot. Fast, clean JSON.

### Why this license scraper?

Most "license verification" scrapers cover a single state board or a single profession, and many just re-scrape Google Maps business listings. This actor unifies **four state licensing boards** into one normalized dataset and lets you target **any profession across all of them at once** — the regulatory data that directories don't have (license number, official status, issue/expiration dates, disciplinary flags).

| Data | Typical scrapers | This actor |
|---|---|---|
| Multiple state boards in one run | ❌ single state | ✅ CO, CT, DE, TX |
| All professions (not just one vertical) | ❌ | ✅ |
| Official license number & status | partial | ✅ |
| Issue / renewal / expiration dates | ❌ | ✅ |
| Filter by expiration (renewal-timing leads) | ❌ | ✅ |
| Disciplinary-action flag (DE) | ❌ | ✅ |
| Full street address (CT) | ❌ | ✅ |
| Lead score (0–100) | ❌ | ✅ |
| Monitoring — only new/renewed licenses | ❌ | ✅ |

#### Coverage

| State | Source | Records | Highlights |
|---|---|---|---|
| **Connecticut** | DCP — State Licenses & Credentials | ~2.6M | Full street address; all credentials |
| **Colorado** | DORA — Professional & Occupational Licenses | ~1.6M | City + ZIP; official verify link |
| **Texas** | TDLR — All Licenses | ~962K | Trades (HVAC, electrical, cosmetology…) + business/owner name |
| **Delaware** | DPR — Professional & Occupational Licensing | ~350K | Disciplinary-action flag; license type |

### Use cases

- **Lead generation** — licensed professionals are active B2B buyers: they need insurance (E\&O, liability, malpractice), CE courses, practice-management & CRM software, supplies, association membership, and financing. Target a profession (`professionKeywords`) and score the leads.
- **Renewal-timing outreach** — use `expiringBefore` to find licenses expiring soon — ideal for insurance renewals, continuing-education providers, and membership drives.
- **Fresh-licensee prospecting** — use `issuedAfter` (+ monitoring) to capture newly-licensed professionals the moment they appear.
- **License verification & compliance** — confirm a license number, status, and expiration; flag disciplinary actions (DE).
- **Market & workforce intelligence** — count and map licensed professionals by profession, city, county, and state.
- **Recruiting & staffing** — build candidate lists of credentialed nurses, therapists, trades, and other licensed roles by location.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **US Professional License Scraper**, pick states and enter `professionKeywords` (e.g. `nurse`, `electric`, `real estate`), and click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "states": ["CO", "CT", "DE", "TX"],
    "professionKeywords": ["nurse"],
    "statusActiveOnly": true,
    "issuedAfter": "2025-01-01",
    "maxResults": 1000,
    "sortNewestFirst": true,
    "monitorMode": false
}
```

- **states** — which state boards to query (`CO`, `CT`, `DE`, `TX`). Empty = all four.
- **professionKeywords** — keywords matched against each state's profession / license-type field (`nurse`, `electric`, `real estate`, `cosmetolog`, `physician`, `pharmac`, `engineer`, `dentist`, `veterinar`, `cpa`, `counselor`…). Empty = all professions. *(Colorado uses license-type codes — common professions are mapped automatically; you can also pass a raw CO code like `RN` or `DEN`.)*
- **statusActiveOnly** *(default true)* — active/current licenses only (for TX, keeps non-expired).
- **cities / zipCodes** — location filters (CO, CT, DE).
- **counties** — county filter (Texas).
- **nameQuery** — licensee name contains.
- **issuedAfter** — only licenses first issued on/after this date (fresh leads; CO/CT/DE).
- **expiringBefore** — only licenses expiring before this date (renewal-timing leads).
- **maxResults / maxResultsPerState** — output limits.
- **sortNewestFirst** *(default true)* — most recently issued first.
- **monitorMode / monitorKey** — emit only licenses new (or renewed) since the last run.
- **socrataAppToken** *(optional)* — higher rate limits for very large runs.

### Output

One record per license (`recordType: "license"`):

```json
{
    "recordType": "license",
    "jurisdiction": "CT",
    "fullName": "SAMANTHA G WILSON",
    "profession": "Emergency Medical Technician",
    "licenseType": "Emergency Medical Technician",
    "licenseNumber": "13734",
    "licenseStatus": "ACTIVE",
    "active": true,
    "disciplinaryAction": null,
    "issueDate": "2011-06-09",
    "expirationDate": "2027-03-31",
    "street": "13 RAMBLEWOOD DRIVE",
    "city": "Gales Ferry",
    "state": "CT",
    "zipCode": "06335",
    "county": null,
    "addressFull": "13 RAMBLEWOOD DRIVE, Gales Ferry, CT 06335",
    "verifyUrl": "https://www.elicense.ct.gov/",
    "leadScore": 84,
    "scrapedAt": "2026-06-20T03:00:00.000Z"
}
```

Fields vary by state (each board publishes a different set): Colorado adds `lastRenewedDate` and an official per-license `verifyUrl`; Delaware adds `disciplinaryAction` and `profession`; Texas adds `businessName`, `ownerName`, `county`, and `continuingEducationCompleted`. Fields are `null` only when that board doesn't publish them.

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly to capture newly-licensed professionals and upcoming renewals; combine with `monitorMode` so each run returns only what's new.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/us-professional-license-scraper').call({
    states: ['CO', 'CT', 'DE', 'TX'],
    professionKeywords: ['real estate'],
    issuedAfter: '2025-01-01',
    maxResults: 2000,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} license leads`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps — no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new license leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new licensees.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. You can call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find active electrics licensed in Texas and Colorado" and let it run this scraper for you.

### Agent-ready: autonomous payments (x402 & Skyfire)

This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:

- **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

### More scrapers from scrapesage

Build a complete **US B2B lead-gen stack** with official-data siblings:

- **[US Business Formation Scraper](https://apify.com/scrapesage/us-business-formation-scraper)** — newly-registered LLCs & corporations (fresh business leads).
- **[US Contractor License Scraper](https://apify.com/scrapesage/us-contractor-license-scraper)** — state contractor boards with surety bond & insurance data.
- **[SBA Loan Leads Scraper](https://apify.com/scrapesage/sba-loan-leads-scraper)** — recently-financed small businesses (7(a) & 504).
- **[NPI NPPES Scraper](https://apify.com/scrapesage/npi-nppes-scraper)** — 8M+ US healthcare providers from the national registry.
- **[TaxBuzz Scraper](https://apify.com/scrapesage/taxbuzz-scraper)** — CPA & tax-preparer leads.
- **[FindLaw Scraper](https://apify.com/scrapesage/findlaw-scraper)** — attorney & law-firm leads.
- **[Healthgrades Scraper](https://apify.com/scrapesage/healthgrades-scraper)** — doctor & provider leads with reviews.
- **[Insurance Agent Scraper](https://apify.com/scrapesage/insurance-agent-scraper)** — agency leads.
- **[GSA eLibrary Scraper](https://apify.com/scrapesage/gsa-elibrary-scraper)** — federal-contractor leads.

### Tips

- **Target a vertical**: set `professionKeywords` (e.g. `["nurse"]`, `["electric","hvac"]`, `["real estate"]`) — it's matched per state, so one keyword reaches every board.
- **Renewal campaigns**: combine `expiringBefore` with a profession to build a list of professionals due to renew.
- **Fresh leads on a schedule**: set `issuedAfter` + `monitorMode` and run on a daily [Schedule](https://docs.apify.com/platform/schedules) to capture new licensees only.
- **Colorado professions**: CO publishes license-type *codes*. Common professions (nurse, cosmetologist, engineer, CPA, dentist, veterinarian, pharmacist, counselor, electric, etc.) are mapped automatically; for anything else, pass the raw CO code.

### FAQ

**Which states are covered?** Colorado, Connecticut, Delaware, and Texas — the states that publish complete, individual-level license data on official open-data portals. More states are added over time.

**Do I need an API key?** No. The data comes from public state open-data portals; no key, login, or browser is required. An optional Socrata app token only raises rate limits for very large runs.

**Can I get one profession across all states?** Yes — that's the point. `professionKeywords` is matched against each state's profession field, so a single keyword like `nurse` returns nurses from every selected board in one run.

**Does it include contact emails or phone numbers?** State boards generally don't publish those. This actor returns the official record — name, profession, license number, status, dates, and the mailing address the board publishes (CT includes full street address; CO/DE include city + ZIP; TX includes county).

**How do I monitor new licenses automatically?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules). Each run returns only licenses that are new (or newly renewed) since the last run, tagged `monitorEvent: "new"`.

**Is this legal?** This actor collects publicly available government records only. You are responsible for using the data in compliance with applicable laws (e.g. GDPR/CCPA where relevant) and each portal's terms.

**A field is null — why?** Each state board publishes a different set of fields. A field is `null` when that particular board doesn't publish it (e.g. Texas has no street address; only CT publishes street).

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests — including additional states — are welcome.

# Actor input Schema

## `states` (type: `array`):

Which state licensing datasets to query. Each is an official state open-data portal: <b>CT</b> (2.6M credentials, full street address), <b>CO</b> (1.6M), <b>TX</b> (962K TDLR trades), <b>DE</b> (350K, incl. disciplinary flag). Leave empty for all four.

## `professionKeywords` (type: `array`):

Filter by profession — keywords matched (case-insensitive, any match) against each state's profession / license-type field. e.g. <code>nurse</code>, <code>electric</code>, <code>real estate</code>, <code>cosmetolog</code>, <code>physician</code>, <code>pharmac</code>, <code>engineer</code>, <code>dentist</code>, <code>veterinar</code>, <code>counselor</code>, <code>cpa</code>. Leave empty for ALL professions. <i>(Colorado uses license-type codes — common professions are mapped automatically; you can also pass a raw CO code like <code>RN</code> or <code>DEN</code>.)</i>

## `statusActiveOnly` (type: `boolean`):

Only return licenses with an active/current status (for TX, which has no status field, this keeps licenses whose expiration date has not passed). Turn off to include expired, lapsed, and historical records.

## `cities` (type: `array`):

Filter by licensee city (case-insensitive, exact city name), e.g. <code>Denver</code>, <code>Hartford</code>. Applies to CO, CT and DE (Texas has no city field).

## `zipCodes` (type: `array`):

Filter by ZIP — full ZIP (<code>80202</code>) or a prefix (<code>802</code> matches all 802xx). Applies to CO, CT and DE.

## `counties` (type: `array`):

Filter by county — applies to Texas TDLR (business county), e.g. <code>Harris</code>, <code>Travis</code>, <code>Dallas</code>.

## `nameQuery` (type: `string`):

Only return licensees whose name (person or business) contains this text (case-insensitive).

## `issuedAfter` (type: `string`):

Only licenses first issued on or after this date, <code>YYYY-MM-DD</code> — great for fresh leads (newly licensed professionals). Applies to CO, CT and DE (Texas has no issue date and is skipped when this is set).

## `expiringBefore` (type: `string`):

Only licenses expiring before this date, <code>YYYY-MM-DD</code> — perfect for renewal-timing outreach (insurance, CE providers, associations).

## `maxResults` (type: `integer`):

Maximum number of license records to return in this run (across all selected states).

## `maxResultsPerState` (type: `integer`):

Cap how many records are pulled from each state before the global limit and sorting are applied. Leave blank to use the same value as Max results.

## `sortNewestFirst` (type: `boolean`):

Return the most recently issued licenses first (best for fresh leads). Texas has no issue date, so its records are returned in license-number order.

## `deduplicateResults` (type: `boolean`):

Skip duplicate license records within this run (recommended).

## `monitorMode` (type: `boolean`):

Remember which licenses were already returned (in a named key-value store) and emit ONLY licenses that are new since the last run — each tagged <code>monitorEvent: "new"</code>. A renewal (new expiration date) also surfaces as new. State portals refresh regularly; run on a Schedule to capture newly-licensed professionals as fresh leads. Works alongside Apify Schedules (the schedule starts the run; monitoring decides what's new).

## `monitorKey` (type: `string`):

Names the memory used by monitoring mode. Use a distinct key per saved watch (e.g. per state/profession) so different monitors don't share state.

## `socrataAppToken` (type: `string`):

Optional Socrata app token for higher rate limits on very large runs. Not required — leave blank for normal use. Get one free at any state open-data portal.

## `proxyConfiguration` (type: `object`):

Optional proxy. State open data is fetched directly and needs no proxy — leave this off for the fastest runs. Enable Apify Proxy only if your network requires it.

## Actor input object example

```json
{
  "states": [
    "CO",
    "CT",
    "DE",
    "TX"
  ],
  "professionKeywords": [
    "nurse"
  ],
  "statusActiveOnly": true,
  "maxResults": 1000,
  "sortNewestFirst": true,
  "deduplicateResults": true,
  "monitorMode": false,
  "monitorKey": "default",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped professional-license records as JSON items in the default dataset.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "states": [
        "CO",
        "CT",
        "DE",
        "TX"
    ],
    "professionKeywords": [
        "nurse"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/us-professional-license-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "states": [
        "CO",
        "CT",
        "DE",
        "TX",
    ],
    "professionKeywords": ["nurse"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/us-professional-license-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 '{
  "states": [
    "CO",
    "CT",
    "DE",
    "TX"
  ],
  "professionKeywords": [
    "nurse"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scrapesage/us-professional-license-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapesage/us-professional-license-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/g0hD7Ugv4dOrreXNp/builds/BZRfXNbn6EscOHLu1/openapi.json