# Virginia License Leads Scraper - Contractors, Realtors & Pros (`scrapesage/virginia-license-leads-scraper`) Actor

Scrape Virginia DPOR licensed pros & businesses: contractors, tradesmen, realtors/brokers, appraisers, architects, engineers, home inspectors, HOA managers, cosmetologists & more. Get name, e-mail, address, license number, type, status & expiration. Filter by profession, city & renewal date.

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

## Pricing

$6.00 / 1,000 license lead 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

## Virginia License Leads Scraper — Contractors, Realtors, Appraisers & Pros (with Email)

Build a clean, sales-ready **B2B lead list of every licensed professional and business in Virginia** straight from the official **[Virginia DPOR](https://www.dpor.virginia.gov/) Regulant Lists** — the Commonwealth's public-records roster of contractors, tradesmen, real-estate agents & brokers, appraisers & AMCs, architects, engineers & surveyors, home inspectors, HOA managers, cosmetologists & salons, auctioneers, opticians and more.

Every record ships with the **licensee or business name, e‑mail address of record, full mailing address, license number, license type, rank & specialty, status, and the issue & expiration dates** — so you can prospect by profession, by city, and by **renewal-timing window**.

No login, no API key, no browser — fast, reliable extraction straight from the official Virginia DPOR public files.

### Why this Virginia license scraper?

Most "Virginia license" tools are single-board lookup utilities that make you type one license number at a time and hand back a bare status. This actor downloads the **entire official roster** for any board and turns it into a rich, deduplicated, lead-scored dataset — **with the e‑mail address DPOR publishes** (most state license rolls have none).

| Data | Typical lookup tools | This actor |
|---|---|---|
| Bulk roster (no license number needed) | ❌ one-at-a-time | ✅ whole board(s) |
| Licensee / business name (parsed) | partial | ✅ first / middle / last / suffix + firm |
| **E‑mail address of record** | ❌ | ✅ ~80–95% coverage |
| Full mailing address (street, city, state, ZIP+4) | partial | ✅ |
| License number, type, **rank & specialty** | partial | ✅ |
| Status + **expiration date** (renewal timing) | partial | ✅ |
| Issue date → newly-licensed / business-age signal | ❌ | ✅ |
| Individuals **and** businesses / firms | partial | ✅ both |
| 18 boards / 170+ license types in one run | ❌ | ✅ |
| Lead score (0–100) + lead signals | ❌ | ✅ |
| **Only-new monitoring** of new & renewed licenses | ❌ | ✅ |
| One clean table — no empty columns | ❌ | ✅ |

### Use cases

- **Lead generation** — licensed pros and firms are active buyers: contractors need insurance, surety bonds, financing, materials, software & marketing; real-estate agents, brokers & appraisers need lead tools, CRMs, signage and E\&O; HOA managers need vendors; salons need supplies and booking software. Reach them directly with the published **e‑mail** + mailing address.
- **Renewal-timing campaigns** — filter by `expiringWithinDays` to catch licenses approaching their renewal date for CE providers, insurers and bond agencies.
- **New-business / new-licensee feeds** — filter by `issuedAfter` to find pros and companies that just got licensed.
- **Market & competitive intelligence** — size and map a profession across Virginia by city, ZIP, rank and specialty.
- **Compliance, verification & enrichment** — append official license numbers, status, expiration and classifications to your existing records.

### 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 **Virginia License Leads Scraper**, pick one or more **boards / professions**, set filters (status, city, ZIP, renewal window, etc.) 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
{
    "boards": ["contractors", "real-estate", "real-estate-appraisers"],
    "statusFilter": "active",
    "cities": ["Richmond", "Virginia Beach", "Arlington"],
    "withEmailOnly": true,
    "expiringWithinDays": 120,
    "sortBy": "leadScore",
    "maxResults": 1000
}
```

- **boards** *(default `["contractors"]`)* — which DPOR rosters to pull. Choose any of: Contractors & Tradesmen, Real Estate (brokers/salespersons/firms/settlement agents), Real Estate Appraisers & AMCs, Architects/Engineers/Surveyors/Interior Designers, Asbestos/Lead/Home Inspectors, Community Association (HOA) Managers, Barbers/Cosmetologists/Nail/Wax/Tattoo/Esthetics & Salons, Auctioneers, Opticians & Hearing Aid Specialists, Soil Scientists & Geologists, Waterworks/Wastewater/Onsite Sewage, Waste Management, Cemetery, Branch Pilots, Polygraph Examiners, Athlete Agents, Boxing/Wrestling/Martial Arts, Fair Housing.
- **statusFilter** *(default `active`)* — `active`, `all`, or `inactive`. Real-estate & appraiser boards publish separate active/inactive rosters; other boards publish a current roster (expired records inside it are flagged).
- **recordTypes** — keep only `individual` or `business` records.
- **licenseCodes** — filter to specific DPOR codes (board+occupation), e.g. `2701` (Class A Contractor), `2710` (Tradesman), `0226` (Real Estate Firm), `4009` (AMC), `0402` (Professional Engineer).
- **cities / zipCodes / states** — geographic filters.
- **nameQuery / businessNameQuery** — substring match on the licensee or company name.
- **withEmailOnly / withBusinessNameOnly / withStreetAddressOnly** — quality filters.
- **expiringWithinDays** — keep licenses expiring within N days (renewal timing).
- **issuedAfter** *(YYYY-MM-DD)* — keep licenses originally issued on/after this date (newly licensed).
- **minLeadScore / sortBy / maxResults / deduplicateResults / includeRawFields** — output controls.
- **monitorMode / monitorKey** — emit only new/changed licenses across runs (see below).

### Output

One record per license:

```json
{
    "state2": "VA",
    "board": "Board for Contractors",
    "boardKey": "contractors",
    "category": "Construction & Trades",
    "licenseNumber": "2701030496",
    "certificateNumber": "030496",
    "licenseCode": "2701",
    "boardCode": "27",
    "occupationCode": "01",
    "licenseType": "Class A Contractor",
    "licenseRank": "A",
    "licenseSpecialty": "H/H",
    "recordType": "business",
    "name": "Froehling & Robertson INC",
    "firstName": null,
    "lastName": null,
    "businessName": "Froehling & Robertson INC",
    "email": "jclingenpeel@fandr.com",
    "street": "3015 Dumbarton Rd",
    "city": "Richmond",
    "state": "VA",
    "zip": "23228",
    "zipExtension": null,
    "country": "US",
    "issueDate": "1987-08-31",
    "expirationDate": "2027-08-31",
    "fullAddress": "3015 Dumbarton Rd, Richmond, VA, 23228",
    "hasEmail": true,
    "isActive": true,
    "status": "Active",
    "expiresInDays": 436,
    "isExpiringSoon": false,
    "isExpired": false,
    "businessAgeYears": 38.8,
    "isNewlyLicensed": false,
    "licenseLookupUrl": "https://dporweb.dpor.virginia.gov/LicenseLookup/Search?licenseNumber=2701030496",
    "leadScore": 82,
    "leadSignals": ["Business / firm licensee"],
    "scrapedAt": "2026-06-21T12:00:00.000Z"
}
```

Set `includeRawFields: true` (default) to also attach the raw DPOR `sourceFields` row for full transparency.

### 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 weekly/monthly to catch newly-issued and just-renewed licenses; DPOR refreshes the rosters every ~5 business days.
- **[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/virginia-license-leads-scraper').call({
    boards: ['contractors', 'real-estate'],
    statusFilter: 'active',
    withEmailOnly: true,
    expiringWithinDays: 120,
    maxResults: 2000,
});

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

#### Monitor mode — only new & renewed licenses

Turn on **`monitorMode`** and the actor remembers everything it has emitted (in a named key-value store) and, on the next run, returns **only new or changed** licenses — newly issued, renewed (new expiration), moved (new address) or updated e‑mail. Pair it with a **[Schedule](https://docs.apify.com/platform/schedules)** to build an always-fresh feed of new Virginia license leads. Monitor mode works independently of the Apify scheduler — use any cadence you like, and use a distinct `monitorKey` per saved search.

### 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. 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 Class A contractors in Richmond with an email and a license expiring in the next 90 days" 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 license & local-business lead-gen stack**:

- **[Florida License Leads Scraper](https://apify.com/scrapesage/florida-license-leads-scraper)** — the Florida DBPR sibling: contractors, realtors, CAMs, vets, cosmetologists & more.
- **[US Contractor License Scraper](https://apify.com/scrapesage/us-contractor-license-scraper)** — official state contractor boards (CSLB, WA, OR) with bond & insurance.
- **[US Real Estate License Scraper](https://apify.com/scrapesage/us-real-estate-license-scraper)** — agents, brokers, brokerages & appraisers from NY/TX/CO boards.
- **[US Professional License Scraper](https://apify.com/scrapesage/us-professional-license-scraper)** — licensed pros across TX, CO, CT & DE boards.
- **[BuildZoom Scraper](https://apify.com/scrapesage/buildzoom-scraper)** — contractor profiles, licenses, permits & reviews.
- **[US Building Permits Scraper](https://apify.com/scrapesage/us-building-permits-scraper)** — construction & contractor activity by city.
- **[US Property Records Scraper](https://apify.com/scrapesage/us-property-records-scraper)** — property owner leads.
- **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — enrich any licensee's website for extra emails, phones & socials.

### Tips

- **Cost & speed** — each board downloads its full official roster, so add boards deliberately. The default `contractors` board is fast and cheap; Real Estate and Cosmetology are the largest.
- **Renewal campaigns** — combine `statusFilter: active`, `expiringWithinDays`, and `sortBy: expirationSoon`.
- **Find firms** — set `withBusinessNameOnly: true` (or `recordTypes: ["business"]`) for B2B company leads such as contracting firms, brokerages and AMCs.
- **Recurring monitoring** — combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to track only newly issued & renewed licenses.

### FAQ

**Where does the data come from?** The official Virginia Department of Professional & Occupational Regulation (DPOR) "Regulant Lists" — public-records files published by the Commonwealth and refreshed every ~5 business days. No API key or login needed.

**Does it include e‑mail addresses?** Yes — DPOR publishes the regulant's e‑mail address of record, and most records have one (roughly 80–95% depending on the board). Use `withEmailOnly: true` to keep only records that have one.

**Is there a phone number?** No — DPOR does not publish phone numbers in the regulant lists. You get name, e‑mail and full mailing address. To add phones, enrich the licensee's website with the [Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper).

**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**How do I get only newly licensed or just-renewed pros?** Use `issuedAfter` for new licenses, `expiringWithinDays` for upcoming renewals, or turn on `monitorMode` with a [Schedule](https://docs.apify.com/platform/schedules) to receive only new/changed records each run.

**Is scraping this data legal?** This actor collects publicly available government records published by Virginia DPOR. You are responsible for using the data in compliance with applicable laws (e.g. CAN-SPAM, TCPA, GDPR/CCPA) and DPOR's terms.

**A field is null — why?** Some records genuinely omit a street, e‑mail or specialty. Fields are `null` only when the source doesn't publish them, not because the scraper skipped them.

### 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; this actor is actively maintained.

# Actor input Schema

## `boards` (type: `array`):

Which Virginia DPOR regulant rosters to pull. Each board downloads its official Regulant List file(s), so add only what you need (bandwidth scales with selection). Real estate, contractors and cosmetology are the largest.

## `statusFilter` (type: `string`):

Which licenses to keep. Real estate & appraiser boards publish separate active/inactive rosters; other boards publish a current roster (expired records inside it are flagged).

## `recordTypes` (type: `array`):

Keep only individuals, only businesses/firms, or both (default).

## `licenseCodes` (type: `array`):

Filter to specific DPOR license codes (board + occupation), e.g. 2701 (Class A Contractor), 2710 (Tradesman), 0226 (Real Estate Firm), 4009 (AMC), 0402 (Professional Engineer). Leave empty for all license types in the selected boards.

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

Keep only licensees in these cities (case-insensitive), e.g. Richmond, Virginia Beach, Norfolk, Arlington, Alexandria.

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

Keep only licensees in these 5-digit ZIP codes.

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

Keep only licensees with these state codes (most are VA; some hold Virginia licenses from out of state).

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

Keep only records whose licensee name or business name contains this text.

## `businessNameQuery` (type: `string`):

Keep only records whose business / firm name contains this text (e.g. a franchise or company name).

## `withEmailOnly` (type: `boolean`):

Keep only licensees that have a published e-mail address of record (most do).

## `withBusinessNameOnly` (type: `boolean`):

Keep only licensees that have an associated company name (B2B firms).

## `withStreetAddressOnly` (type: `boolean`):

Drop records that only have a city/ZIP (no street).

## `expiringWithinDays` (type: `integer`):

Keep only licenses that expire within this many days — ideal for renewal-timing, CE and insurance prospecting.

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

Keep only licenses originally issued on/after this date — find newly-licensed pros and new businesses.

## `minLeadScore` (type: `integer`):

Keep only records with a lead score (0–100) at or above this value.

## `sortBy` (type: `string`):

Ordering of the (capped) output.

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

Maximum number of license records to output (after filtering & sorting).

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

Collapse duplicate rows by license number + name (recommended).

## `includeRawFields` (type: `boolean`):

Attach the raw DPOR record (sourceFields) to each output item for full transparency.

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

Remember licenses across runs and emit only NEW or CHANGED ones (status, expiration, address or e-mail change). Great for tracking newly-issued and just-renewed licenses. Works independently of Apify Schedules — use a Schedule to run it on a cadence.

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

Namespace for monitor memory. Use a distinct key per saved search so their states don't collide.

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

DPOR files download cleanly from Apify datacenter IPs — the default Apify Proxy is recommended.

## Actor input object example

```json
{
  "boards": [
    "contractors"
  ],
  "statusFilter": "active",
  "withEmailOnly": false,
  "withBusinessNameOnly": false,
  "withStreetAddressOnly": false,
  "sortBy": "leadScore",
  "maxResults": 1000,
  "deduplicateResults": true,
  "includeRawFields": true,
  "monitorMode": false,
  "monitorKey": "default",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

All Virginia DPOR license lead 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/virginia-license-leads-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/virginia-license-leads-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 '{}' |
apify call scrapesage/virginia-license-leads-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/olRV7392q2gbcCL4n/builds/j9pffdEXG11Qga7or/openapi.json