NC General Contractor License Scraper

Search the official North Carolina Licensing Board for General Contractors (NCLBGC) public registry and return structured license records for contractor verification, lead research, compliance workflows, and directory enrichment.

What it extracts

Each default-dataset item represents one license detail record and includes:

Field	Description
licenseName, alternateName	Public licensee/company names
licenseNumber, status, renewalDate	License identity and public status fields
limitation, classifications	License limitation and classifications
qualifiers	Public qualifier names associated with the license
address1, address2, city, state, zip, county	Public business address fields
telephone	Public phone field, when supplied
sourceUrl, sourceSearchUrl, scrapedAt	Provenance and UTC collection timestamp

Input

Provide at least one search filter. The Board supports combinations of filters:

{
  "licenseName": "Acme Builders",
  "county": "Wake",
  "maxResults": 25,
  "maxPages": 5
}

For an exact lookup:

{ "licenseNumber": "12345", "maxResults": 1 }

maxResults defaults to 25 and is capped at 500. maxPages defaults to 5 and is capped at 25. The scraper uses the Board’s own public JSON search and detail endpoints; it does not require login credentials or cookies.

Output and pricing

Records are written to the default dataset. The OUTPUT key-value record contains recordsCollected, chargedEvents, pagesVisited, blocked, filters, and warnings.

Event	Price
Actor start	$0.00005
License record	$0.003 per delivered record

Examples: one exact license lookup costs up to $0.00305; 25 delivered records cost up to $0.07505, excluding any Apify platform proxy or runtime usage outside the event prices.

Reliability and limitations

The Actor submits the public search form at the official NCLBGC portal, parses the returned HTML result table, then loads each public account-detail and qualifier page. It retries through an Apify US proxy when direct website access fails, deduplicates by license number, validates each record before writing, and stops at the configured result limit. A valid search with no matches returns zero records and a diagnostic summary. HTTP errors, timeouts, malformed HTML, TLS failures, or access blocks are reported in OUTPUT; the Actor never fabricates license records.

The Board controls the public fields and availability of its registry. This Actor is a read-only interface to public records, not a legal determination that a contractor is currently authorized for a particular project. Verify important licensing decisions with NCLBGC and comply with applicable laws, terms, and privacy requirements.

Source

Official source: https://portal.nclbgc.org/Public/Search

Use cases

• Build public prospect lists and qualify organizations or professionals before responsible outreach.
• Compare listings, locations, availability, and market signals for property research.
• Run a one-off research job and export the structured result as JSON, CSV, Excel, XML, or RSS from Apify.
• Schedule the same input to monitor changes over time and send completed datasets to a webhook or integration.
• Feed schema-shaped records into a database, spreadsheet, BI tool, or AI workflow with the source URL retained for verification.

Run NC General Contractor License Scraper with the Apify API

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/nc-licensing-board-general-contractors-scraper').call({
  "licenseName": "Acme Builders",
  "licenseNumber": "12345",
  "county": "Wake",
  "address": "Raleigh",
  "maxResults": 25,
  "maxPages": 5,
  "requestDelayMs": 500
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

You can also run the Actor from Apify Console, schedules, webhooks, the REST API, Make, Zapier, n8n, or the hosted Apify MCP server.

Frequently asked questions

Can I schedule NC General Contractor License Scraper?

Yes. Use an Apify schedule to run the same saved input at a chosen interval, then connect a webhook or integration to process the dataset when the run finishes.

How should I test a new input?

Begin with the prefilled example or a small limit. Confirm that the output fields, source coverage, runtime, and live charges match your workflow before increasing the scope.

How do I export the results?

Open the run's default dataset in Apify Console and export JSON, CSV, Excel, XML, or RSS. Applications can retrieve the same records through the Apify API client or REST dataset endpoint.

Can an AI agent call this Actor?

Yes. Add muhammadafzal/nc-licensing-board-general-contractors-scraper through the hosted Apify MCP server or call it through the API. The Actor's input and dataset schemas help agents construct valid requests and interpret returned records.