# North Carolina Electrical Contractor Leads Scraper (NCBEEC) (`memo23/north-carolina-electrical-contractor-leads-scraper`) Actor Scrape license-verified electrician leads from North Carolina's state board (NCBEEC) — business name, license number, class, status, expiry, address, phone, and qualifier decision-makers. Full-state sweep or city/company/license search. Opt-in contact-email finding. JSON or CSV out. - **URL**: https://apify.com/memo23/north-carolina-electrical-contractor-leads-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** Lead generation, Agents, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 license-verified electrician leads 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 ## North Carolina Electrical Contractor Leads Scraper (NCBEEC) **License-verified electrician leads, straight from the state board.** Every row is pulled live from the North Carolina State Board of Examiners of Electrical Contractors public registry — business name, license number, classification, status, expiration date, mailing address, phone, and the licensed qualifier individuals behind each company. Sweep the whole state or target a city, classification, company, or license number. Opt-in contact-email finding turns registry records into outreach-ready leads. JSON or CSV out, billed per lead. #### How it works ![How NC Electrical Contractor Leads Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-nc-electrical-leads.png) #### ✨ Why use this scraper? - **License-verified, not directory-scraped** — every lead comes from the board's own registry, so the license number, classification, status, and expiry are authoritative at scrape time. - **Decision-makers included** — each company row carries its *qualifiers*: the named, individually licensed electricians who stand behind the license. That's who signs off the work. - **Active-only by default** — Terminated / Not Active / Not Valid records are dropped before you pay for them (turn `activeOnly` off for compliance or historical research). - **Full-state sweep built in** — run it with an empty input and it walks a bundled list of ~1,500 NC place names, metro areas first. No URL hunting. - **Opt-in contact emails** — the actor discovers each business's own website (search + directory filtering + name-match guard) and harvests a contact email from it. You're only charged when an email is actually found. - **New-license monitoring** — flip `monitoringMode` on a schedule and each run returns only contractors licensed since your last run: the freshest leads in the state. - **Zero setup** — US residential proxy is built in; the board's registry is public, no login or CAPTCHA involved. #### 🎯 Use cases | Who | What they do with it | |---|---| | **Trade suppliers & distributors** | Build call lists of active licensed electricians by city and classification — with phone, address, and the qualifier names to ask for | | **SaaS & fintech selling to trades** | Feed license-verified contractor accounts into outbound; `enrichEmails` + `qualifyByPayment` qualify who can actually buy online | | **Insurance, bonding & lending** | Verify license status and expiration before quoting; `includePublicMatters` adds the disciplinary record | | **Recruiters & M&A scouts** | Map every Unlimited-classification shop in a metro; monitor newly licensed firms as expansion signals | | **General contractors & developers** | Verify subs' licenses in bulk from a license-number list before award | #### 📥 Supported inputs | Mode | Input | Behaviour | |---|---|---| | **Full-state sweep** (default) | *(empty input)* | Walks the bundled NC place list, biggest cities first | | **City sweep** | `cities: ["Charlotte", "Raleigh"]` | Exact match on the licensee's mailing-address city | | **Company search** | `companyNames: ["electric"]` | Board-side substring match on company name | | **Name search** | `lastName` (+ optional `firstName`) | License-holder name lookup | | **License lookup** | `licenseNumbers: ["U.00025"]` | Direct verification; accepts `U.00025` or bare digits | | **Phone lookup** | `phoneNumber` | Phone number on record | **Not supported:** other states or boards (this actor covers the NC electrical board — see the fabric note in FAQ), NC general contractors (NCLBGC is a different board), plumbing/HVAC licenses (separate NC board, separate actor). #### 🔄 How it works 1. **Builds search jobs** from your criteria — or the full-state city list when the input is empty. 2. **Queries the board's live roster** for each job and parses the result rows (license #, classification, holder, standing). 3. **Filters** inactive licenses (default), unwanted classifications, and duplicates — before any per-lead fetching, so you never pay for records you filtered out. 4. **Fetches each license's detail record** — name, DBA, address, phone, status, expiry — plus its qualifier individuals, in parallel. 5. **Optionally enriches**: discovers the business's own website (search-engine + directory blocklist + name-match guard) and scrapes a contact email from it; `qualifyByPayment` additionally detects Stripe/e-commerce signals. 6. **Pushes one row per license** to the dataset — qualifiers and enrichment merged inline. #### ⚙️ Input parameters | Field | Type | Default | Description | |---|---|---|---| | `cities` | array | `[]` → full sweep | NC mailing-address cities, matched exactly | | `classifications` | array | `[]` → all | Any of the 10 board classifications (label, fragment like `unlimited`, or numeric code) | | `activeOnly` | boolean | `true` | Drop licenses not in good standing before fetching | | `companyNames` | array | — | Substring company-name searches | | `lastName` / `firstName` | string | — | License-holder name search | | `licenseNumbers` | array | — | Direct license lookups | | `phoneNumber` | string | — | Phone-number search | | `includePublicMatters` | boolean | `false` | Fetch disciplinary records per licensee (+1 request each) | | `enrichEmails` | boolean | `false` | Website discovery + contact-email harvesting | | `qualifyByPayment` | boolean | `false` | Payment-processor detection (needs `enrichEmails`) | | `monitoringMode` | boolean | `false` | Only licenses not delivered on previous runs | | `resetMonitoringState` | boolean | `false` | One-shot: clear the monitoring baseline | | `maxItems` | integer | `500` | Hard cap on leads | | `maxConcurrency` | integer | `10` | Parallel detail fetches | | `searchConcurrency` | integer | `3` | Parallel roster searches | #### 📊 Output overview One dataset row per license. The row merges the roster entry, the board's detail record, the qualifier list, and (when enabled) email enrichment — there are no separate or padding rows. `isActive` is computed from the authoritative detail status, and `searchCity` records which sweep query surfaced the lead. #### 📦 Output sample Real trimmed row from a live run: ```json { "type": "license-lead", "stateCode": "NC", "trade": "electrical", "boardId": "ncbeec", "boardName": "North Carolina State Board of Examiners of Electrical Contractors", "licenseNumber": "U.00025", "classificationCode": "U", "classification": "Unlimited Classification License", "businessName": "Interstate Electric Company LLC", "dbaName": null, "licenseStatus": "Active", "statusNote": null, "isActive": true, "expirationDate": "2027-02-28", "phone": "(704) 333-7149", "address": { "street": "4241 Taggart Creek Road", "city": "Charlotte", "state": "NC", "zip": "28208", "raw": "4241 Taggart Creek Road, Charlotte, NC 28208" }, "searchCity": "Charlotte", "qualifiers": [ { "name": "David Wayne Morrison", "qualifierNumber": "QUAL.U.05776", "status": "Active" }, { "name": "Stuart Dale Robertson Jr.", "qualifierNumber": "QUAL.U.06725", "status": "Active" }, { "name": "Michael John Capuano", "qualifierNumber": "QUAL.U.10213", "status": "Active" }, { "name": "Justin Glenn Rhoden", "qualifierNumber": "QUAL.U.12921", "status": "Active" } ], "sourceUrl": "https://arls-public.ncbeec.org/Public/Search", "scrapedAt": "2026-07-23T15:54:10.895Z" } ```` With `enrichEmails: true`, successful rows additionally carry: ```json { "contactEmail": "service@example-electric.com", "contactWebsite": "https://example-electric.com", "emailEnrichment": { "website": "…", "emails": ["…"], "source": "site-scrape", "confidence": "high" } } ``` #### 🗂 Key output fields | Group | Fields | |---|---| | **License** | `licenseNumber`, `classification`, `classificationCode`, `licenseStatus`, `statusNote`, `isActive`, `expirationDate` | | **Business** | `businessName`, `dbaName`, `phone`, `address.{street,city,state,zip,raw}` | | **People** | `qualifiers[]` — name, qualifier number, status of each licensed individual | | **Compliance** (opt-in) | `publicMatters[]` — the board's public disciplinary records | | **Enrichment** (opt-in) | `contactEmail`, `contactWebsite`, `emailEnrichment`, `takesPayments`, `paymentProcessors`, `stripeLiveKey`, `paymentConfidence` | | **Provenance** | `boardId`, `boardName`, `stateCode`, `trade`, `searchCity`, `sourceUrl`, `scrapedAt` | #### ❓ FAQ **How complete is the full-state sweep?** The board's search matches on each licensee's *mailing-address city*. The bundled sweep list covers ~1,500 NC municipalities, CDPs, and USPS alias spellings, so in-state coverage is effectively complete; licensees whose mailing address is outside NC are only found via company/name/license searches. **What's the email hit rate?** Expect roughly a third of active companies to yield a verified contact email — small local trades often have no website at all. You're only charged the email event when one is found; misses cost nothing. The `emailEnrichment.website` field is best-effort and can occasionally point at a same-named business elsewhere — `confidence` and `source` let you filter. **Why do I see fewer leads than the roster shows?** `activeOnly` (default on) drops licenses not in good standing — on this board that's the majority of historical records. Set it to `false` to get everything. **Can I get plumbing / HVAC contractors too?** NC keeps those on a separate board — covered by the matching **[NC Plumbing & HVAC Contractor Leads Scraper](https://apify.com/memo23/north-carolina-plumbing-hvac-contractor-leads-scraper)** (plumbing, heating groups, fuel piping, and fire sprinkler classifications). The `Special Restricted Plumbing, Heating and Air Conditioning` classification here is an *electrical* restricted class, not the plumbing board's license. **Does monitoring mode re-charge for old leads?** No. `monitoringMode` remembers every license already delivered to *your* account and silently skips it on later runs — you pay only for new rows. The first monitored run seeds the baseline. **Is this legal to scrape?** The registry is a public government licensing record intended for license verification by the public. The actor accesses only those public pages, politely. See the Disclaimer below for your responsibilities. #### 💬 Support - 🐛 **Issues:** [the actor's Issues tab](https://apify.com/memo23/north-carolina-electrical-contractor-leads-scraper/issues) - 💡 **Feature requests:** same place — concrete requests (new fields, other states, other trades) usually ship fast - 📧 **Direct:** message via [my Apify profile](https://apify.com/memo23) #### 🛠 Additional services Need the same license-verified leads pipeline for **another state or trade** (plumbing, HVAC, general contractors), a custom export, or a managed feed into your CRM? This actor is the first of a per-state series built on a shared engine — new boards stamp out quickly. Reach out via my Apify profile. #### 🔎 Explore more scrapers More lead-gen and directory actors from the same author: **[apify.com/memo23](https://apify.com/memo23)** — including email finding & verification, business directories, real-estate, and job boards. #### 🤖 For AI Agents & LLM Apps This actor is MCP-ready: call it from agent frameworks via the [Apify MCP server](https://mcp.apify.com), or hit it with a single API call and read the dataset as clean JSON. The row schema is stable and flat where it matters (`licenseNumber`, `businessName`, `phone`, `address.city`, `isActive`), so it drops straight into RAG pipelines, lead-qualification agents, and compliance-check tools. Typical agent patterns: *"verify this contractor's NC license"* (pass `licenseNumbers`), *"find active unlimited-class electricians in Raleigh with emails"* (pass `cities` + `classifications` + `enrichEmails`), or a scheduled *"alert me on newly licensed contractors"* loop (`monitoringMode`). *** ### ⚠️ Disclaimer This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by the North Carolina State Board of Examiners of Electrical Contractors, the State of North Carolina, or any of their agencies or affiliates. All trademarks mentioned are the property of their respective owners. The scraper accesses only the board's publicly available license-verification pages — no authenticated endpoints and no content behind a login. License data is a public record published for verification purposes; contact-email enrichment visits only the businesses' own public websites. Users are responsible for ensuring their use complies with applicable law and regulation — including data-protection rules (GDPR, CCPA), telemarketing/e-mail regulations (TCPA, CAN-SPAM) when contacting leads, and any obligations of their own organisation. *** ### SEO Keywords north carolina electrical contractor leads, nc electrician leads, ncbeec license lookup, nc electrical license verification, electrical contractor license scraper, licensed electrician database north carolina, nc contractor leads scraper, electrician email list north carolina, state licensing board scraper, contractor license verify api, home services leads scraper, electrical contractor database, nc license status check, apify contractor leads, b2b trades leads, hvac plumbing electrical leads, newly licensed contractors alerts, contractor license monitoring, charlotte electrician list, raleigh electrical contractors # Actor input Schema ## `cities` (type: `array`): NC cities to sweep, matched EXACTLY against each licensee's mailing-address city (e.g. `Charlotte`, `Winston Salem`). Empty = the bundled full-state place list, biggest cities first. ## `classifications` (type: `array`): Keep only these license classifications. Empty = all ten. Values may also be typed as a fragment (`unlimited`) or the board's numeric code (`154`). ## `activeOnly` (type: `boolean`): Keep only licenses in good standing — Terminated / Not Active / Not Valid records are dropped before any detail fetch. Turn off for historical or compliance research. ## `companyNames` (type: `array`): Company-name searches (the board substring-matches, so `electric` finds every company containing the word). Overrides the city sweep. ## `lastName` (type: `string`): Search by the license holder's last name. Overrides the city sweep. ## `firstName` (type: `string`): Optional, only used together with the last name. ## `licenseNumbers` (type: `array`): Direct license lookups — accepts `U.00025` or bare digits (`25`). Overrides every other mode. ## `phoneNumber` (type: `string`): Search by the phone number on record. Overrides the city sweep. ## `includePublicMatters` (type: `boolean`): Also fetch each licensee's public disciplinary matters (adds one request per lead). Adds the `publicMatters` array to every row. ## `enrichEmails` (type: `boolean`): Discover each business's website and harvest a contact email from it. Adds `contactEmail`, `contactWebsite`, and the detailed `emailEnrichment` object. Best-effort — no charge on misses. ## `qualifyByPayment` (type: `boolean`): Piggybacks on email enrichment (only runs when that's on): detects Stripe/Square/e-commerce signals on the business site. Adds `takesPayments`, `paymentProcessors`, `stripeLiveKey`, `paymentConfidence`. Free. ## `monitoringMode` (type: `boolean`): Skip licenses already delivered to you on previous runs — ideal on a schedule for catching newly licensed contractors. The first run seeds the baseline and returns everything. ## `resetMonitoringState` (type: `boolean`): One-shot: forget every previously delivered license at run start, so this run returns everything again. ## `maxItems` (type: `integer`): Hard cap on leads pushed to the dataset. ## `maxConcurrency` (type: `integer`): Parallel per-licensee detail fetches. ## `searchConcurrency` (type: `integer`): Parallel roster searches. Each returns up to ~500 rows; keep modest to stay polite to the board. ## Actor input object example ```json { "cities": [ "Charlotte", "Raleigh", "Durham" ], "classifications": [], "activeOnly": true, "includePublicMatters": false, "enrichEmails": false, "qualifyByPayment": false, "monitoringMode": false, "resetMonitoringState": false, "maxItems": 500, "maxConcurrency": 10, "searchConcurrency": 3 } ``` # 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 = { "cities": [ "Charlotte", "Raleigh", "Durham" ] }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/north-carolina-electrical-contractor-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "cities": [ "Charlotte", "Raleigh", "Durham", ] } # Run the Actor and wait for it to finish run = client.actor("memo23/north-carolina-electrical-contractor-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 '{ "cities": [ "Charlotte", "Raleigh", "Durham" ] }' | apify call memo23/north-carolina-electrical-contractor-leads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=memo23/north-carolina-electrical-contractor-leads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "North Carolina Electrical Contractor Leads Scraper (NCBEEC)", "description": "Scrape license-verified electrician leads from North Carolina's state board (NCBEEC) — business name, license number, class, status, expiry, address, phone, and qualifier decision-makers. Full-state sweep or city/company/license search. Opt-in contact-email finding. JSON or CSV out.", "version": "0.0", "x-build-id": "uwR83xIf9EvWYb2vm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~north-carolina-electrical-contractor-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-north-carolina-electrical-contractor-leads-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/memo23~north-carolina-electrical-contractor-leads-scraper/runs": { "post": { "operationId": "runs-sync-memo23-north-carolina-electrical-contractor-leads-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/memo23~north-carolina-electrical-contractor-leads-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-north-carolina-electrical-contractor-leads-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": { "cities": { "title": "Cities (mailing address)", "type": "array", "description": "NC cities to sweep, matched EXACTLY against each licensee's mailing-address city (e.g. `Charlotte`, `Winston Salem`). Empty = the bundled full-state place list, biggest cities first.", "items": { "type": "string" } }, "classifications": { "title": "License classifications", "type": "array", "description": "Keep only these license classifications. Empty = all ten. Values may also be typed as a fragment (`unlimited`) or the board's numeric code (`154`).", "items": { "type": "string", "enum": [ "Unlimited Classification License", "Intermediate Classification License", "Limited Classification License", "Single Family Detached Residential Dwelling Classification License", "Special Restricted Fire Alarm/Low Voltage Classification License", "Special Restricted Plumbing, Heating and Air Conditioning Classification License", "Special Restricted Elevator Classification License", "Special Restricted Electric Sign Classification License", "Special Restricted Swimming Pool Classification License", "Special Restricted Groundwater Pump ClassificationLicense" ] }, "default": [] }, "activeOnly": { "title": "Active licenses only", "type": "boolean", "description": "Keep only licenses in good standing — Terminated / Not Active / Not Valid records are dropped before any detail fetch. Turn off for historical or compliance research.", "default": true }, "companyNames": { "title": "Company names", "type": "array", "description": "Company-name searches (the board substring-matches, so `electric` finds every company containing the word). Overrides the city sweep.", "items": { "type": "string" } }, "lastName": { "title": "Licensee last name", "type": "string", "description": "Search by the license holder's last name. Overrides the city sweep." }, "firstName": { "title": "Licensee first name", "type": "string", "description": "Optional, only used together with the last name." }, "licenseNumbers": { "title": "License numbers", "type": "array", "description": "Direct license lookups — accepts `U.00025` or bare digits (`25`). Overrides every other mode.", "items": { "type": "string" } }, "phoneNumber": { "title": "Phone number", "type": "string", "description": "Search by the phone number on record. Overrides the city sweep." }, "includePublicMatters": { "title": "Include disciplinary records", "type": "boolean", "description": "Also fetch each licensee's public disciplinary matters (adds one request per lead). Adds the `publicMatters` array to every row.", "default": false }, "enrichEmails": { "title": "Find contact emails (opt-in)", "type": "boolean", "description": "Discover each business's website and harvest a contact email from it. Adds `contactEmail`, `contactWebsite`, and the detailed `emailEnrichment` object. Best-effort — no charge on misses.", "default": false }, "qualifyByPayment": { "title": "Detect payment processors", "type": "boolean", "description": "Piggybacks on email enrichment (only runs when that's on): detects Stripe/Square/e-commerce signals on the business site. Adds `takesPayments`, `paymentProcessors`, `stripeLiveKey`, `paymentConfidence`. Free.", "default": false }, "monitoringMode": { "title": "Only new licenses since last run", "type": "boolean", "description": "Skip licenses already delivered to you on previous runs — ideal on a schedule for catching newly licensed contractors. The first run seeds the baseline and returns everything.", "default": false }, "resetMonitoringState": { "title": "Reset monitoring baseline", "type": "boolean", "description": "One-shot: forget every previously delivered license at run start, so this run returns everything again.", "default": false }, "maxItems": { "title": "Maximum leads", "minimum": 1, "type": "integer", "description": "Hard cap on leads pushed to the dataset.", "default": 500 }, "maxConcurrency": { "title": "Detail concurrency", "minimum": 1, "type": "integer", "description": "Parallel per-licensee detail fetches.", "default": 10 }, "searchConcurrency": { "title": "Search concurrency", "minimum": 1, "type": "integer", "description": "Parallel roster searches. Each returns up to ~500 rows; keep modest to stay polite to the board.", "default": 3 } } }, "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 } } } } } } } } } } ```