# 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 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
## 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: CT (2.6M credentials, full street address), CO (1.6M), TX (962K TDLR trades), DE (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. nurse, electric, real estate, cosmetolog, physician, pharmac, engineer, dentist, veterinar, counselor, cpa. Leave empty for 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` (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. Denver, Hartford. Applies to CO, CT and DE (Texas has no city field).
## `zipCodes` (type: `array`):
Filter by ZIP — full ZIP (80202) or a prefix (802 matches all 802xx). Applies to CO, CT and DE.
## `counties` (type: `array`):
Filter by county — applies to Texas TDLR (business county), e.g. Harris, Travis, Dallas.
## `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, YYYY-MM-DD — 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, YYYY-MM-DD — 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 monitorEvent: "new". 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 '' with your token
const client = new ApifyClient({
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 '' with your token.
client = ApifyClient("")
# 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 "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "US Professional License Scraper - Licensed Pro Leads",
"description": "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.",
"version": "0.1",
"x-build-id": "ANvGvoqIQFKgDG11d"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~us-professional-license-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-us-professional-license-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/scrapesage~us-professional-license-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-us-professional-license-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/scrapesage~us-professional-license-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-us-professional-license-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",
"properties": {
"states": {
"title": "States",
"type": "array",
"description": "Which state licensing datasets to query. Each is an official state open-data portal: CT (2.6M credentials, full street address), CO (1.6M), TX (962K TDLR trades), DE (350K, incl. disciplinary flag). Leave empty for all four.",
"items": {
"type": "string",
"enum": [
"CO",
"CT",
"DE",
"TX"
],
"enumTitles": [
"Colorado (DORA)",
"Connecticut (DCP)",
"Delaware (DPR)",
"Texas (TDLR)"
]
},
"default": [
"CO",
"CT",
"DE",
"TX"
]
},
"professionKeywords": {
"title": "Profession / license keywords",
"type": "array",
"description": "Filter by profession — keywords matched (case-insensitive, any match) against each state's profession / license-type field. e.g. nurse, electric, real estate, cosmetolog, physician, pharmac, engineer, dentist, veterinar, counselor, cpa. Leave empty for ALL professions. (Colorado uses license-type codes — common professions are mapped automatically; you can also pass a raw CO code like RN or DEN.)",
"items": {
"type": "string"
}
},
"statusActiveOnly": {
"title": "Active licenses only",
"type": "boolean",
"description": "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.",
"default": true
},
"cities": {
"title": "Cities",
"type": "array",
"description": "Filter by licensee city (case-insensitive, exact city name), e.g. Denver, Hartford. Applies to CO, CT and DE (Texas has no city field).",
"items": {
"type": "string"
}
},
"zipCodes": {
"title": "ZIP codes (prefix)",
"type": "array",
"description": "Filter by ZIP — full ZIP (80202) or a prefix (802 matches all 802xx). Applies to CO, CT and DE.",
"items": {
"type": "string"
}
},
"counties": {
"title": "Counties (Texas)",
"type": "array",
"description": "Filter by county — applies to Texas TDLR (business county), e.g. Harris, Travis, Dallas.",
"items": {
"type": "string"
}
},
"nameQuery": {
"title": "Name contains",
"type": "string",
"description": "Only return licensees whose name (person or business) contains this text (case-insensitive)."
},
"issuedAfter": {
"title": "Issued on/after (optional)",
"type": "string",
"description": "Only licenses first issued on or after this date, YYYY-MM-DD — 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": {
"title": "Expiring before (optional)",
"type": "string",
"description": "Only licenses expiring before this date, YYYY-MM-DD — perfect for renewal-timing outreach (insurance, CE providers, associations)."
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"type": "integer",
"description": "Maximum number of license records to return in this run (across all selected states).",
"default": 1000
},
"maxResultsPerState": {
"title": "Max results per state (optional)",
"minimum": 1,
"type": "integer",
"description": "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": {
"title": "Newest licenses first",
"type": "boolean",
"description": "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.",
"default": true
},
"deduplicateResults": {
"title": "Deduplicate within a run",
"type": "boolean",
"description": "Skip duplicate license records within this run (recommended).",
"default": true
},
"monitorMode": {
"title": "Monitoring mode — only new licenses",
"type": "boolean",
"description": "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 monitorEvent: \"new\". 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).",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "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.",
"default": "default"
},
"socrataAppToken": {
"title": "Socrata app token (optional)",
"type": "string",
"description": "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": {
"title": "Proxy configuration",
"type": "object",
"description": "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.",
"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
}
}
}
}
}
}
}
}
}
}
```