Virginia DPOR Contractor License Leads Scraper

Export official Virginia contractor license records from the Department of Professional and Occupational Regulation (DPOR).

Turn Class A, B, and C regulant lists into structured, filterable contractor leads with certificate numbers, business names, addresses, specialties, expiration dates, and public emails.

The Actor reads DPOR's official bulk files directly. No browser, login, or user-supplied URL is required. The files are advertised as refreshed every five business days, making the Actor useful for scheduled prospecting and compliance checks.

What does this Virginia contractor license scraper do?

The Actor downloads the official DPOR contractor lists for the classes you select. It validates every source header, parses tab-delimited rows, normalizes dates and whitespace, applies your filters, removes duplicates, and saves matching records.

Use it to:

• 🏗️ build Virginia contractor lead lists;
• ✉️ find records containing public business emails;
• 🧰 target DPOR specialty codes such as HIC, ELE, or PLB;
• 📍 segment businesses by city, state, or ZIP code;
• 📅 monitor certification and expiration dates;
• ✅ retain official source URLs and source values for auditing.

The Actor does not invent an active/inactive status. DPOR's bulk contractor files do not publish that field, so the output preserves dates without making unsupported status claims.

Who is it for?

Construction suppliers

Find contractors by territory and specialty for material, equipment, and service outreach. Filter to records with email addresses before importing the dataset into a CRM.

Insurance and compliance teams

Schedule exports and monitor licenses approaching an expiration window. Keep source URLs and fetched timestamps with every record.

Contractor marketplaces

Populate or refresh Virginia provider profiles with official certificate numbers, classes, specialties, and business locations.

Local B2B sales teams

Create city- or ZIP-specific lists for Richmond, Norfolk, Virginia Beach, Roanoke, or any other territory represented in DPOR data.

Data engineers

Use the Apify API, webhooks, schedules, dataset exports, and integrations to feed a warehouse or enrichment pipeline.

Why use official Virginia DPOR bulk data?

• Authoritative source: records come from Virginia DPOR.
• Bulk coverage: one run can process Class A, B, and C files.
• Lead-ready fields: many source records include a public email.
• Transparent provenance: every item includes its exact source file URL.
• Repeatable refreshes: schedule the Actor around DPOR's five-business-day update cadence.
• Fail-safe parsing: unexpected header changes stop the run instead of silently shifting columns.

What contractor license data can I extract?

Field	Description
certificateNumber	DPOR certificate number preserved as text
individualName	Individual name when supplied
businessName	Licensed business name
licenseClass	Class A, B, or C
specialties	Normalized DPOR specialty code array
specialtiesSource	Specialty text exactly as published after whitespace cleanup
email	Public email from the source file
fullAddress	Combined mailing/business address
city, state, zipCode	Location components
expirationDate	ISO YYYY-MM-DD expiration date
certificationDate	ISO YYYY-MM-DD certification date
expirationDateSource	Original DPOR date value
board, occupation	DPOR board and occupation codes
sourceUrl	Official Class A, B, or C text file
fetchedAt	UTC fetch timestamp

Separate address lines, PO box, ZIP extension, province, country, and international postal code are also retained.

How to run the scraper

1. Open the Actor input page.
2. Select one or more license classes.
3. Optionally enter specialty, business-name, or location filters.
4. Optionally choose an expiration-date window.
5. Choose whether records must contain an email.
6. Set a maximum result count.
7. Click Start.
8. Open the dataset to preview or export JSON, CSV, Excel, XML, RSS, or HTML.

For a quick first run, keep Class A selected, require an email, and request 25 results.

Input parameters

Input	Type	Default	Purpose
licenseClasses	string array	['A']	Official contractor lists to process
specialties	string array	empty	Exact DPOR specialty codes; any match qualifies
businessNames	string array	empty	Case-insensitive business-name substrings
cities	string array	empty	Exact city matches
states	string array	empty	Exact state abbreviations
zipCodes	string array	empty	Exact five-digit ZIP codes
expiresAfter	date	empty	Inclusive lower expiration bound
expiresBefore	date	empty	Inclusive upper expiration bound
emailRequirement	enum	any	Any, with email, or without email
maxResults	integer	100	Maximum matching records, up to 50,000

Empty filter arrays mean “do not filter by this field.” Date filtering excludes source values that cannot be safely normalized.

Input examples

Public-email leads across all classes

{
  "licenseClasses": ["A", "B", "C"],
  "emailRequirement": "withEmail",
  "maxResults": 500
}

Richmond home-improvement contractors

{
  "licenseClasses": ["A"],
  "specialties": ["HIC"],
  "cities": ["RICHMOND"],
  "maxResults": 250
}

Virginia-address businesses expiring in a window

{
  "licenseClasses": ["A", "B", "C"],
  "states": ["VA"],
  "expiresAfter": "2026-08-01",
  "expiresBefore": "2026-08-31",
  "maxResults": 1000
}

Output example

{
  "board": "27",
  "occupation": "05",
  "certificateNumber": "082040",
  "individualName": "",
  "businessName": "CORNERSTONE ENGINEERING AND CONSULTING SERVICES PLLC",
  "addressLine1": "1272 NELLIE JONES RD",
  "addressLine2": "",
  "poBox": "",
  "fullAddress": "1272 NELLIE JONES RD, LA CROSSE, VA, 23950",
  "city": "LA CROSSE",
  "state": "VA",
  "zipCode": "23950",
  "zipCodeExtension": "0000",
  "province": "",
  "country": "",
  "postalCode": "",
  "expirationDate": "2028-02-29",
  "expirationDateSource": "02/29/2028",
  "certificationDate": "2004-02-03",
  "certificationDateSource": "02/03/2004",
  "licenseClass": "A",
  "specialties": ["EMW", "ENV"],
  "specialtiesSource": "EMW ENV",
  "email": "bdougherty@cornerstoneusa.net",
  "sourceUrl": "https://www.dpor.virginia.gov/sites/default/files/Records%20and%20Documents/Regulant%20List/2705a__crnt.txt",
  "fetchedAt": "2026-07-22T00:00:00.000Z"
}

Empty source fields are exported as empty strings so CSV columns stay predictable.

How much does it cost to scrape Virginia contractor licenses?

This Actor uses pay-per-event pricing:

• a $0.005 start charge covers source download and validation;
• an item charge applies to each contractor record saved;
• subscription tiers receive automatic per-record discounts.

Apify plan tier	Price per contractor record	1,000 records plus start
Free	$0.000026894	$0.031894
Bronze	$0.000023386	$0.028386
Silver	$0.000018241	$0.023241
Gold	$0.000014032	$0.019032
Platinum	$0.000010000	$0.015000
Diamond	$0.000010000	$0.015000

The Console shows the exact estimated price before you start a run. Filters can reduce output charges because only matching records are saved. A 20-record prefilled run costs about $0.0055 before Apify credits.

Apify's Free plan includes monthly platform credits, which may cover small test exports depending on current plan terms.

Specialty filtering tips

DPOR specialty values are compact codes, not descriptive labels. Enter exact tokens such as HIC rather than a phrase such as “home improvement.”

• Use one code to target a narrow trade.
• Add several codes to accept records matching any one of them.
• Run a small unfiltered export first to inspect current codes.
• Preserve specialtiesSource when downstream systems need the source representation.

The Actor does not guess or enrich specialty labels, avoiding incorrect classifications when DPOR revises its code list.

Lead-generation workflow

1. Select all relevant contractor classes.
2. Limit the dataset to your sales territory.
3. Set emailRequirement to withEmail.
4. Add specialty codes aligned with your offer.
5. Export the result to CSV or connect a webhook.
6. Deduplicate against your CRM using certificateNumber plus licenseClass.
7. Re-run after DPOR refreshes its lists.

Always apply appropriate outreach laws, consent rules, and suppression lists. A published business email is data availability, not automatic marketing consent.

Compliance and renewal monitoring workflow

Create an Apify schedule with an expiration window relevant to your review cycle. Send the dataset to Slack, email, a webhook, or a database. Compare certificate numbers with the previous snapshot.

Useful checks include:

• contractors newly entering an expiration window;
• changes in business location or public email;
• newly listed certification dates;
• specialty-code changes between snapshots;
• missing records requiring manual source verification.

Keep fetchedAt, raw dates, and sourceUrl for traceability.

Integrations

Google Sheets

Use the Google Sheets integration to create a territory list for sales operations. Map certificateNumber as a text column to preserve leading zeros.

Webhooks and CRMs

Trigger a webhook when the Actor finishes, then upsert records into HubSpot, Salesforce, Pipedrive, or your internal CRM. Use certificate number, class, and specialties as the stable composite key.

Make and Zapier

Create no-code flows that notify account owners when matching contractor records appear or enter an expiration window.

Data warehouses

Pull dataset items through the API into BigQuery, Snowflake, PostgreSQL, or object storage. Retain raw date and specialty fields for auditing.

Run with the Apify API

Replace APIFY_TOKEN with your token. The Actor ID is automation-lab/virginia-dpor-contractor-license-leads-scraper.

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/virginia-dpor-contractor-license-leads-scraper').call({
  licenseClasses: ['A', 'B', 'C'],
  emailRequirement: 'withEmail',
  maxResults: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('automation-lab/virginia-dpor-contractor-license-leads-scraper').call(run_input={
    'licenseClasses': ['A'],
    'specialties': ['HIC'],
    'maxResults': 100,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

cURL

curl -X POST \
  'https://api.apify.com/v2/acts/automation-lab~virginia-dpor-contractor-license-leads-scraper/runs?token=APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"licenseClasses":["A"],"emailRequirement":"withEmail","maxResults":25}'

Use with MCP and AI assistants

Connect the Actor through Apify's MCP server and ask an assistant to run Virginia contractor research.

Claude Code

$claude mcp add --transport http apify "https://mcp.apify.com?tools=automation-lab/virginia-dpor-contractor-license-leads-scraper"

Claude Desktop, Cursor, or VS Code

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=automation-lab/virginia-dpor-contractor-license-leads-scraper"
    }
  }
}

Example prompts:

• “Find 100 Class A Virginia contractor records with public emails.”
• “Export Richmond HIC contractors and summarize counts by ZIP code.”
• “Find contractor licenses expiring next month and group them by class.”

Data quality and reliability

The Actor verifies all 20 expected DPOR columns before parsing rows. If DPOR adds, removes, or renames a column, the run fails with the affected class and schema difference. This is safer than shifting values into the wrong fields.

It also:

• checks that source rank matches the selected file;
• rejects malformed user dates;
• fails closed for unparseable dates when date filters are active;
• retries bounded transient HTTP failures;
• deduplicates records before output;
• preserves source values next to normalized values.

Responsible use and legality

The Actor accesses public government bulk files without bypassing authentication or technical controls. Public availability does not remove your responsibility to use data lawfully.

Before using output:

• review Virginia DPOR's current terms and notices;
• comply with privacy, marketing, and consumer-protection rules;
• honor opt-outs and suppression lists;
• avoid harassment or discriminatory profiling;
• verify critical decisions against the official source;
• secure exported contact data appropriately.

This tool is not legal advice and does not certify that a contractor is active, insured, bonded, or suitable for work.

Troubleshooting

Why did my specialty filter return no records?

DPOR uses exact specialty codes. Run a small export without the specialty filter, inspect specialties, and retry with an observed code. Do not enter a descriptive trade name unless it is itself a published token.

Why is an ISO date empty?

The original value remains in expirationDateSource or certificationDateSource. An empty normalized date means the source value was blank or could not be safely parsed as MM/DD/YYYY. When a date filter is active, such records are excluded.

Why are some business addresses outside Virginia?

Virginia contractor licenses may belong to businesses with out-of-state addresses. Set states to ["VA"] if you only want Virginia-address records.

Why did the run stop with a schema-change error?

DPOR changed a source header or row shape. The Actor intentionally stops rather than returning misaligned data. Open an Actor issue and include the run ID so the parser can be reviewed.

FAQ

How often is the source updated?

Virginia DPOR states that regulant lists are updated every five business days. The fetchedAt field tells you when this Actor downloaded a record.

Does this scrape every Virginia profession?

No. This Actor focuses on contractor occupation code 05 and the official Class A, B, and C contractor files.

Does the output include phone numbers?

No. The current official bulk files do not expose a phone column. The Actor does not fabricate or enrich missing phone data.

Does it tell me whether a license is active?

No unsupported status is inferred. Use the published expiration and certification dates, and verify important cases directly with DPOR.

Can I export all records?

Yes, select A, B, and C and raise maxResults up to 50,000. For first runs, use a smaller limit to validate your workflow and expected cost.

Can I schedule recurring exports?

Yes. Use Apify Schedules and connect the resulting dataset to your preferred integration or webhook.

Related scrapers

Explore complementary actors from Automation Lab:

• Arizona ROC Contractor License Scraper
• Washington Contractor License Scraper
• Oregon Contractor License Scraper
• Professional License Verifier

Choose this Actor when you need Virginia DPOR bulk contractor files, public emails, and specialty-level filtering. Use a state-specific related Actor for another licensing authority or a verifier for single-record checks.

Support

If a run fails or a DPOR file changes, open an issue from the Actor page. Include:

• the run ID;
• the input used;
• the selected license classes;
• the expected filter result;
• whether the problem is reproducible.

Do not include private credentials or unrelated personal data. The source URL in each item helps reproduce data-quality questions quickly.