# US Diverse Supplier Leads Scraper - MBE, WBE, DBE & Veteran (`scrapesage/us-diverse-supplier-leads-scraper`) Actor Scrape official state & city supplier-diversity directories for certified MBE, WBE, DBE, SBE, Veteran-Owned & Service-Disabled-Veteran-Owned businesses. Company, contact name, phone, email, website, NAICS/NIGP codes, certification type & expiry, lead score. Filters + monitoring, keyless, no browser. - **URL**: https://apify.com/scrapesage/us-diverse-supplier-leads-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $7.00 / 1,000 diverse supplier 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 ## US Diverse Supplier Leads Scraper — MBE, WBE, DBE, SBE & Veteran-Owned Certified Businesses Extract **certified diverse-supplier leads** from official **state & city supplier-diversity directories** — the businesses that prime contractors, corporations and government agencies are *required* to find and buy from. Every record is a certified **MBE (minority-owned)**, **WBE (women-owned)**, **DBE (disadvantaged)**, **SBE (small)**, **Veteran-Owned** or **Service-Disabled-Veteran-Owned** business, with the contact data you actually need: **business name, contact person, phone, email, website, full address, NAICS/NIGP industry codes, certification type, certifying agency, and certification/expiry dates** — plus a 0–100 **lead score**. No login, no API key, no browser — fast, keyless JSON extraction straight from government open-data portals. ### Why this diverse-supplier scraper? Supplier-diversity data is scattered across dozens of incompatible state and city portals, each with a different schema, different certification codes, and different field names. This actor **unifies them into one clean, normalized dataset** with a single certification taxonomy — and ships the richest record in the category. | Data | Generic business scrapers | This actor | |---|---|---| | Normalized certification type (MBE/WBE/DBE/SBE/VBE/SDVBE…) | ❌ | ✅ across every program | | Contact name + phone + email | partial | ✅ up to 100% on key programs | | Website | partial | ✅ | | NAICS + NIGP industry codes | ❌ | ✅ | | Certifying agency + certification number | ❌ | ✅ | | Certification / renewal / expiration dates | ❌ | ✅ | | Ethnicity / gender / ownership flags | ❌ | ✅ where published | | Past-contract experience (client, value, scope) | ❌ | ✅ (NYC) | | Lead score (0–100) | ❌ | ✅ | | Monitoring — only newly-certified firms | ❌ | ✅ | ### Sources (official, keyless, multi-state) | State | Program | Certifications | |---|---|---| | **NY** | NYC Dept. of Small Business Services (M/WBE, EBE, LBE) | MBE, WBE, EBE, LBE | | **NY** | NY State Unified Certification Program (UCP) | DBE | | **NY** | NYC Dept. of Veterans’ Services | Veteran / SDVOB | | **NJ** | NJSAVI (Selective Assistance Vendor Information) | SBE, MBE, WBE, Veteran, DVOB | | **DE** | Delaware Office of Supplier Diversity | MBE, WBE, Veteran, SDVOBE, DBE | | **LA** | City of New Orleans Office of Supplier Diversity | SLDBE / DBE | | **VA** | City of Norfolk | SWaM (Small/Women/Minority), DBE | | **OH** | City of Cincinnati Economic Inclusion | SBE, MBE, WBE, LBE, EBE | | **TX** | City of Austin Small & Minority Business Resources | SBE | | **IL** | City of Chicago Dept. of Procurement Services | Veteran-Owned | ### Use cases - **Supplier-diversity sourcing & Tier-2 reporting** — find certified MBE/WBE/DBE/Veteran suppliers by industry (NAICS) and location to hit corporate and federal diversity-spend goals. - **Government & prime-contractor bidding** — assemble a diverse subcontractor bench for DOT, GSA and municipal contracts that mandate DBE participation. - **Lead generation** — sell to certified diverse businesses (lending, insurance, bonding, accounting, marketing, SaaS) with verified phone/email contacts. - **Re-certification & renewal outreach** — target firms whose certifications are expiring soon (`expiringWithinDays`) for renewal services and re-certification help. - **New-certification monitoring** — schedule recurring runs to capture **newly-certified firms** the moment they appear — fresh leads before anyone else has them. - **Market & diversity-spend intelligence** — analyze the certified-supplier landscape by certification type, industry, ethnicity/gender and geography. ### 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 Diverse Supplier Leads Scraper**, choose states/programs and any filters (certification type, NAICS, keyword, city), 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": ["NY", "NJ", "DE"], "certificationTypes": ["MBE", "WBE", "DBE"], "naicsCodes": ["23", "541"], "keyword": "construction", "withEmailOnly": true, "maxResults": 1000, "includeRawFields": true } ```` - **states** — which programs to query (`NY`, `NJ`, `DE`, `LA`, `VA`, `OH`, `TX`, `IL`). Leave empty for **all**. - **certificationTypes** — normalized categories: `MBE`, `WBE`, `DBE`, `ACDBE`, `SBE`, `VBE`, `SDVBE`, `LBE`, `EBE`, `LGBTBE`, `DOBE`. Leave empty for all. - **naicsCodes** — exact (`238220`) or prefix (`23`) NAICS industry codes. - **keyword** — free-text across name, description, industry & commodity codes. - **nameQuery / cities / zipCodes / counties** — narrow by business name or location. - **withEmailOnly / withPhoneOnly / withWebsiteOnly** — keep only records with that contact channel. - **statusActiveOnly** *(default true)* — only currently-active / non-expired certifications. - **certifiedAfter** — only firms certified on/after a date (newly-certified leads). - **expiringBefore / expiringWithinDays** — renewal-timing windows. - **includeRawFields** *(default true)* — attach the original source row as `sourceFields` so no published data is lost. - **monitorMode** *(default false)* — emit only firms new since the last run (see below). ### Output One record per certified business: ```json { "recordType": "supplier", "sourceState": "NJ", "sourceProgram": "New Jersey SAVI Certified Vendor", "source": "New Jersey Selective Assistance Vendor Information — NJSAVI (data.nj.gov)", "businessName": "CW Solutions, Inc.", "contactName": "Stacie Curtis", "phone": "(201) 317-0143", "email": "scurtis@cwcsi.com", "website": null, "street": "409 Joyce Kilmer Avenue", "city": "New Brunswick", "state": "NJ", "zipCode": "08901", "addressFull": "409 Joyce Kilmer Avenue, New Brunswick, NJ 08901", "certifications": ["WBE", "SBE"], "certificationsRaw": ["SBE", "WBE"], "certificationType": "SBE | WBE", "certificationLabels": [ "Women-Owned Business Enterprise (WBE)", "Small Business Enterprise (SBE)" ], "minorityOwned": false, "womenOwned": true, "veteranOwned": false, "serviceDisabledVeteranOwned": false, "smallBusiness": true, "disadvantaged": false, "certifyingAgency": null, "naicsCodes": ["541330"], "commodityDescription": "Engineering, right-of-way & GIS services", "certificationExpirationDate": null, "daysUntilExpiration": null, "expiringSoon": null, "active": true, "leadScore": 78, "leadSignals": ["email", "phone", "contact_name", "street_address", "certified", "multi_certification", "active"], "verifyUrl": "https://www.njportal.com/DOR/SAVI/", "scrapedAt": "2026-06-21T12:00:00.000Z", "sourceFields": { "...": "original source row" } } ``` ### Monitoring — only new suppliers Turn on **monitorMode** to remember which suppliers were already returned (in a named key-value store) and emit **only firms that are new since the last run** — each tagged `monitorEvent: "new"`. A **re-certification** (new expiration/renewal date) also surfaces as new, so you catch renewals too. This is **orthogonal to [Apify Schedules](https://docs.apify.com/platform/schedules)**: the schedule decides *when* the run starts; monitoring decides *what's new*. Combine them — e.g. run daily and only newly-certified MBE/WBE construction firms land in your dataset — perfect for a fresh-lead pipeline. Use a distinct `monitorKey` per saved watch so different monitors don't share state. ### 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, manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run hourly/daily/weekly to monitor newly-certified firms or renewals. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger CRM import, Slack alert or 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-diverse-supplier-leads-scraper').call({ states: ['NY', 'NJ', 'DE'], certificationTypes: ['MBE', 'WBE'], naicsCodes: ['23'], withEmailOnly: true, maxResults: 1000, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} certified diverse-supplier 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 supplier leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds newly-certified firms. - **[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 certified women-owned construction firms in New Jersey with an email" 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 US B2B & government-data scrapers from scrapesage Build a complete **government-contracting & B2B lead stack**: - **[SAM.gov Scraper](https://apify.com/scrapesage/sam-gov-scraper)** — federal contractor & entity registrations. - **[USAspending Scraper](https://apify.com/scrapesage/usaspending-scraper)** — who's winning federal contracts & grants. - **[GSA eLibrary Scraper](https://apify.com/scrapesage/gsa-elibrary-scraper)** — GSA Schedule contract holders. - **[US Federal Grants Scraper](https://apify.com/scrapesage/us-federal-grants-scraper)** — federal grant opportunities & recipients. - **[Single Audit Leads Scraper](https://apify.com/scrapesage/single-audit-leads-scraper)** — federally-funded orgs & their auditors. - **[SBA Loan Leads Scraper](https://apify.com/scrapesage/sba-loan-leads-scraper)** — SBA 7(a)/504 borrowers & lenders. - **[Texas Business Leads Scraper](https://apify.com/scrapesage/texas-business-leads-scraper)** — TX businesses by NAICS industry. - **[US Business Formation Scraper](https://apify.com/scrapesage/us-business-formation-scraper)** — newly-registered LLCs & corporations. - **[US UCC Filings Scraper](https://apify.com/scrapesage/us-ucc-filings-scraper)** — secured-loan & lender leads. - **[US Property Records Scraper](https://apify.com/scrapesage/us-property-records-scraper)** — owner & parcel leads. - **[Customs Broker & Freight Forwarder Leads](https://apify.com/scrapesage/customs-broker-forwarder-leads)** — licensed trade-services leads. - **[FMCSA Trucking Scraper](https://apify.com/scrapesage/fmcsa-trucking-scraper)** — carriers, brokers & freight leads. ### Tips - **Maximum coverage**: leave `states` and `certificationTypes` empty to pull every program and every certification category, then filter the dataset downstream. - **By industry**: use `naicsCodes` prefixes — `23` (construction), `54` (professional services), `48` (transportation), `31`–`33` (manufacturing). - **Renewal campaigns**: set `expiringWithinDays` (e.g. 90) on programs that publish expiry dates (Norfolk, Chicago) for re-certification outreach. - **Cost control**: each record is charged once; use filters and `maxResults` to keep runs lean. ### FAQ **Where does the data come from?** Exclusively from official government open-data portals (Socrata) run by state agencies and city procurement/supplier-diversity offices. No scraping of login-walled or paid databases. **What's the difference between this and SBA's small-business search?** This actor focuses on **state & city certification programs** (MBE/WBE/DBE/SWaM/SBE/Veteran), which are separate from federal SBA certifications (8(a), HUBZone, WOSB). For federal entity registration use the [SAM.gov Scraper](https://apify.com/scrapesage/sam-gov-scraper). **Are the certification codes standardized?** Yes. Each program uses its own labels; this actor maps them to one normalized taxonomy (`certifications`) while preserving the original labels (`certificationsRaw`) and the full source row (`sourceFields`). **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 new certifications automatically?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules); only firms new (or re-certified) since the last run are emitted. **A field is null — why?** Programs publish different fields. A value is `null` only when that program doesn't publish it (e.g. New Orleans lists no email-less firms but no website for some), never because the scraper skipped it. The full original row is in `sourceFields`. **Is this legal?** This actor collects publicly available government open data. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA where personal data applies) and each portal's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests — more states and programs — are welcome; this actor is actively maintained and expanding. # Actor input Schema ## `states` (type: `array`): Which official supplier-diversity programs to query. Each is a state/city open-data portal of certified businesses. NY = NYC SBS (M/WBE, EBE, LBE) + NY State UCP DBE + NYC Veteran-Owned; NJ = NJSAVI (SBE/M/WBE/Veteran); DE = Delaware Office of Supplier Diversity; LA = New Orleans SLDBE/DBE; VA = Norfolk SWaM/DBE; OH = Cincinnati SBE/MBE/WBE; TX = Austin SBE; IL = Chicago Veteran-Owned. Leave empty for ALL programs. ## `certificationTypes` (type: `array`): Filter by certification category (normalized across every program). Leave empty for ALL. MBE minority-owned · WBE women-owned · DBE disadvantaged · ACDBE airport-concession DBE · SBE small business · VBE veteran-owned · SDVBE service-disabled-veteran-owned · LBE local · EBE emerging · LGBTBE LGBT-owned · DOBE disability-owned. ## `naicsCodes` (type: `array`): Filter by NAICS industry code — 23 matches all construction (23xxxx), 238220 matches plumbing/HVAC contractors only. Applies where the program publishes NAICS/commodity codes. ## `keyword` (type: `string`): Free-text match across business name, description, industry/commodity and NAICS title (case-insensitive). e.g. construction, IT services, catering, trucking. ## `nameQuery` (type: `string`): Only suppliers whose business name contains this text (case-insensitive). ## `cities` (type: `array`): Filter by business city (case-insensitive, exact match). e.g. Brooklyn, Newark, Cincinnati. (Applies where the program publishes a city.) ## `zipCodes` (type: `array`): Filter by ZIP-code prefix — 112 matches all 112xx ZIPs, 11215 matches one. ## `counties` (type: `array`): Filter by county (case-insensitive, exact match). Applies where the program publishes a county (e.g. NY State DBE). ## `withEmailOnly` (type: `boolean`): Return only records that include a contact email address. ## `withPhoneOnly` (type: `boolean`): Return only records that include a phone number. ## `withWebsiteOnly` (type: `boolean`): Return only records that include a website. ## `statusActiveOnly` (type: `boolean`): Only return currently-active / non-expired certifications (recommended for lead-gen). Turn off to include expired records where a program publishes them. ## `certifiedAfter` (type: `string`): Only firms first certified on or after this date (YYYY-MM-DD) — perfect for fresh, newly-certified leads. Applies to programs that publish a certification date (Norfolk, Chicago); other programs are skipped when this is set. ## `expiringBefore` (type: `string`): Only certifications expiring before this date (YYYY-MM-DD) — perfect for re-certification / renewal-timing offers. Applies to programs that publish an expiration/renewal date. ## `expiringWithinDays` (type: `integer`): Convenience alternative to "Expiring before": only certifications expiring within this many days from now. ## `maxResults` (type: `integer`): Maximum number of supplier records to return in this run (across all selected states/programs). ## `maxResultsPerSource` (type: `integer`): Cap how many records are pulled from each individual program before the global limit and newest-first sorting are applied. Leave blank to use the same value as Max results. ## `sortNewestFirst` (type: `boolean`): Sort each program's output by most-recent certification date first (where the program publishes one). ## `deduplicateResults` (type: `boolean`): Drop duplicate supplier records within a single run. ## `includeRawFields` (type: `boolean`): Attach the original source row (cleaned of empty values) as sourceFields on every record, so no published data is lost. Turn off for a leaner dataset. ## `monitorMode` (type: `boolean`): Remember which suppliers were already returned (in a named key-value store) and emit ONLY suppliers that are new since the last run — each tagged monitorEvent: "new". A re-certification (new expiration/renewal date) also surfaces as new. Run on a Schedule to capture newly-certified firms 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 / certification type) 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. Free at any state/city open-data portal. ## `proxyConfiguration` (type: `object`): Optional proxy. Government open data is fetched directly and needs no proxy — leave this off for the fastest, cheapest runs. Enable Apify Proxy only if your network requires it. ## Actor input object example ```json { "states": [], "certificationTypes": [], "naicsCodes": [], "cities": [], "zipCodes": [], "counties": [], "withEmailOnly": false, "withPhoneOnly": false, "withWebsiteOnly": false, "statusActiveOnly": true, "maxResults": 1000, "sortNewestFirst": true, "deduplicateResults": true, "includeRawFields": true, "monitorMode": false, "monitorKey": "default", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): All scraped certified diverse-supplier 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/us-diverse-supplier-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 = {} # Run the Actor and wait for it to finish run = client.actor("scrapesage/us-diverse-supplier-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/us-diverse-supplier-leads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/us-diverse-supplier-leads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Diverse Supplier Leads Scraper - MBE, WBE, DBE & Veteran", "description": "Scrape official state & city supplier-diversity directories for certified MBE, WBE, DBE, SBE, Veteran-Owned & Service-Disabled-Veteran-Owned businesses. Company, contact name, phone, email, website, NAICS/NIGP codes, certification type & expiry, lead score. Filters + monitoring, keyless, no browser.", "version": "0.1", "x-build-id": "y7jr1DYrX35SRStCd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~us-diverse-supplier-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-us-diverse-supplier-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/scrapesage~us-diverse-supplier-leads-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-us-diverse-supplier-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/scrapesage~us-diverse-supplier-leads-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-us-diverse-supplier-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": { "states": { "title": "States / programs", "type": "array", "description": "Which official supplier-diversity programs to query. Each is a state/city open-data portal of certified businesses. NY = NYC SBS (M/WBE, EBE, LBE) + NY State UCP DBE + NYC Veteran-Owned; NJ = NJSAVI (SBE/M/WBE/Veteran); DE = Delaware Office of Supplier Diversity; LA = New Orleans SLDBE/DBE; VA = Norfolk SWaM/DBE; OH = Cincinnati SBE/MBE/WBE; TX = Austin SBE; IL = Chicago Veteran-Owned. Leave empty for ALL programs.", "items": { "type": "string", "enum": [ "NY", "NJ", "DE", "LA", "VA", "OH", "TX", "IL" ], "enumTitles": [ "New York (NYC SBS M/WBE + NY State DBE + NYC Veteran)", "New Jersey (NJSAVI)", "Delaware (Office of Supplier Diversity)", "Louisiana (New Orleans DBE)", "Virginia (Norfolk SWaM / DBE)", "Ohio (Cincinnati SBE/MBE/WBE)", "Texas (Austin SBE)", "Illinois (Chicago Veteran-Owned)" ] }, "default": [] }, "certificationTypes": { "title": "Certification types", "type": "array", "description": "Filter by certification category (normalized across every program). Leave empty for ALL. MBE minority-owned · WBE women-owned · DBE disadvantaged · ACDBE airport-concession DBE · SBE small business · VBE veteran-owned · SDVBE service-disabled-veteran-owned · LBE local · EBE emerging · LGBTBE LGBT-owned · DOBE disability-owned.", "items": { "type": "string", "enum": [ "MBE", "WBE", "DBE", "ACDBE", "SBE", "VBE", "SDVBE", "LBE", "EBE", "LGBTBE", "DOBE" ], "enumTitles": [ "MBE — Minority-Owned", "WBE — Women-Owned", "DBE — Disadvantaged Business Enterprise", "ACDBE — Airport Concession DBE", "SBE — Small Business Enterprise", "VBE — Veteran-Owned", "SDVBE — Service-Disabled Veteran-Owned", "LBE — Local Business Enterprise", "EBE — Emerging Business Enterprise", "LGBTBE — LGBT-Owned", "DOBE — Disability-Owned" ] }, "default": [] }, "naicsCodes": { "title": "NAICS codes (exact or prefix)", "type": "array", "description": "Filter by NAICS industry code — 23 matches all construction (23xxxx), 238220 matches plumbing/HVAC contractors only. Applies where the program publishes NAICS/commodity codes.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text match across business name, description, industry/commodity and NAICS title (case-insensitive). e.g. construction, IT services, catering, trucking." }, "nameQuery": { "title": "Business name contains", "type": "string", "description": "Only suppliers whose business name contains this text (case-insensitive)." }, "cities": { "title": "Cities", "type": "array", "description": "Filter by business city (case-insensitive, exact match). e.g. Brooklyn, Newark, Cincinnati. (Applies where the program publishes a city.)", "default": [], "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes (prefix)", "type": "array", "description": "Filter by ZIP-code prefix — 112 matches all 112xx ZIPs, 11215 matches one.", "default": [], "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Filter by county (case-insensitive, exact match). Applies where the program publishes a county (e.g. NY State DBE).", "default": [], "items": { "type": "string" } }, "withEmailOnly": { "title": "Only suppliers with an email", "type": "boolean", "description": "Return only records that include a contact email address.", "default": false }, "withPhoneOnly": { "title": "Only suppliers with a phone", "type": "boolean", "description": "Return only records that include a phone number.", "default": false }, "withWebsiteOnly": { "title": "Only suppliers with a website", "type": "boolean", "description": "Return only records that include a website.", "default": false }, "statusActiveOnly": { "title": "Active certifications only", "type": "boolean", "description": "Only return currently-active / non-expired certifications (recommended for lead-gen). Turn off to include expired records where a program publishes them.", "default": true }, "certifiedAfter": { "title": "Certified on/after (newly certified)", "type": "string", "description": "Only firms first certified on or after this date (YYYY-MM-DD) — perfect for fresh, newly-certified leads. Applies to programs that publish a certification date (Norfolk, Chicago); other programs are skipped when this is set." }, "expiringBefore": { "title": "Certification expiring before", "type": "string", "description": "Only certifications expiring before this date (YYYY-MM-DD) — perfect for re-certification / renewal-timing offers. Applies to programs that publish an expiration/renewal date." }, "expiringWithinDays": { "title": "Expiring within N days", "minimum": 1, "type": "integer", "description": "Convenience alternative to \"Expiring before\": only certifications expiring within this many days from now." }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of supplier records to return in this run (across all selected states/programs).", "default": 1000 }, "maxResultsPerSource": { "title": "Max results per program (optional)", "minimum": 1, "type": "integer", "description": "Cap how many records are pulled from each individual program before the global limit and newest-first sorting are applied. Leave blank to use the same value as Max results." }, "sortNewestFirst": { "title": "Newest certifications first", "type": "boolean", "description": "Sort each program's output by most-recent certification date first (where the program publishes one).", "default": true }, "deduplicateResults": { "title": "Deduplicate within a run", "type": "boolean", "description": "Drop duplicate supplier records within a single run.", "default": true }, "includeRawFields": { "title": "Include raw source fields", "type": "boolean", "description": "Attach the original source row (cleaned of empty values) as sourceFields on every record, so no published data is lost. Turn off for a leaner dataset.", "default": true }, "monitorMode": { "title": "Monitoring mode — only new suppliers", "type": "boolean", "description": "Remember which suppliers were already returned (in a named key-value store) and emit ONLY suppliers that are new since the last run — each tagged monitorEvent: \"new\". A re-certification (new expiration/renewal date) also surfaces as new. Run on a Schedule to capture newly-certified firms 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 / certification type) 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. Free at any state/city open-data portal." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. Government open data is fetched directly and needs no proxy — leave this off for the fastest, cheapest 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 } } } } } } } } } } ```