# SBA Dynamic Small Business Search Scraper (`automation-lab/sba-dynamic-small-business-search-scraper`) Actor Find SBA Small Business Search / DSBS supplier leads with contacts, UEI, CAGE, NAICS, certifications, capabilities, and profile URLs. - **URL**: https://apify.com/automation-lab/sba-dynamic-small-business-search-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## SBA Dynamic Small Business Search Scraper Extract supplier leads from the public SBA Small Business Search / DSBS database. Use this actor to find small businesses for federal contracting, set-aside sourcing, partner discovery, market research, and procurement outreach. ### What does SBA Dynamic Small Business Search Scraper do? This actor searches the public SBA Small Business Search website and exports structured business profile rows. It captures company names, UEI, CAGE code, contacts, addresses, NAICS codes, business types, certifications, capability keywords, capability narratives, and profile URLs. ### Who is it for? - 🏛️ Federal buyers building supplier lists for market research. - 🤝 Prime contractors looking for certified small-business partners. - 📊 GovCon consultants researching set-aside markets. - 📬 Sales teams prospecting public-sector suppliers. - 🔎 Analysts monitoring SBA small-business profile coverage. ### Why use this actor? SBA Small Business Search is useful, but manual searches are slow when you need a reusable lead list. This actor converts the public search results into clean JSON, CSV, Excel, or API-ready dataset rows. ### Data you can extract | Field | Description | | --- | --- | | legalBusinessName | Registered business name | | dbaName | Doing-business-as name | | uei | Unique Entity ID | | cageCode | CAGE code | | contactPerson | Public contact name | | email | Public email | | phone | Public phone | | address fields | Street, city, state, ZIP, county | | naicsPrimary | Primary NAICS code | | naicsAllCodes | All listed NAICS codes | | certifications | SBA certification flags when exposed | | businessTypes | Ownership and business type flags | | capabilitiesNarrative | Supplier capability text | | profileUrl | Public SBA profile URL | ### How much does it cost to scrape SBA Small Business Search? The actor uses pay-per-event pricing. You pay a small start fee for each run and a per-business fee for each saved supplier profile. The exact tiered prices are shown on the Apify Store page before you run the actor. ### Quick start 1. Enter a search term such as `roofing`, `cybersecurity`, `janitorial`, or `bridge inspection`. 2. Optionally add state codes like `VA` or `TX`. 3. Set `maxItems` to the number of supplier rows you want. 4. Run the actor. 5. Export the dataset as CSV, Excel, JSON, or through the Apify API. ### Input options #### searchTerm Free-text search term for business names, capabilities, services, products, or keywords. #### stateCodes Optional state or territory postal codes. Example: `VA`, `TX`, `CA`. #### naicsCodes Optional NAICS codes for industry targeting. Example: `541511`, `236220`, `561720`. #### primaryNaicsOnly When enabled, NAICS filters match only the primary NAICS code. #### keywords Optional capability keywords to combine with the main search. #### sbaCertificationCodes Advanced field for raw SBA certification filter values used by the public SBA site. Leave it empty unless you already know the SBA code. #### activeSamOnly Return only suppliers marked active in SAM.gov. #### includeProfileDetails Fetches each public profile endpoint after the search row is found. This is slower but can fill additional public detail fields. #### maxItems Caps the number of business rows saved to the dataset. Use a low number for quick tests and a higher number for production lead lists. ### Example input ```json { "searchTerm": "roofing", "stateCodes": ["VA"], "maxItems": 100, "activeSamOnly": false, "includeProfileDetails": false } ```` ### Example output ```json { "legalBusinessName": "EXAMPLE CONSTRUCTION LLC", "dbaName": null, "uei": "ABC123EXAMPLE", "cageCode": "1A2B3", "contactPerson": "Jane Doe", "email": "jane@example.com", "phone": "5551234567", "city": "ARLINGTON", "state": "Virginia", "naicsPrimary": "236220", "naicsAllCodes": ["236220", "541330"], "businessTypes": ["Small business"], "profileUrl": "https://search.certifications.sba.gov/profile/ABC123EXAMPLE/1A2B3" } ``` ### Tips for better supplier searches Use specific buying terms instead of very broad words. For example, `roofing` is better than `construction` when you need roofing contractors. Combine `searchTerm` with `stateCodes` for regional market research. Use NAICS codes when you already know the procurement category. ### Federal contracting workflows This actor works well for: - Sources-sought market research. - Small-business subcontracting plans. - Set-aside supplier discovery. - Partner shortlists for bids. - Capability statement collection. - Local supplier mapping by state. ### Integrations Send results to Google Sheets for a shared supplier list. Export CSV files for CRM import. Use the Apify API to refresh supplier lists weekly. Connect datasets to Make, Zapier, or n8n for lead routing. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/sba-dynamic-small-business-search-scraper').call({ searchTerm: 'janitorial', stateCodes: ['TX'], maxItems: 100 }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('automation-lab/sba-dynamic-small-business-search-scraper').call(run_input={ 'searchTerm': 'cybersecurity', 'stateCodes': ['VA'], 'maxItems': 100, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~sba-dynamic-small-business-search-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchTerm":"roofing","stateCodes":["VA"],"maxItems":100}' ``` ### MCP usage Use Apify MCP with Claude Desktop, Claude Code, or another MCP client. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/sba-dynamic-small-business-search-scraper ``` Claude Code setup: ```bash claude mcp add apify-sba-search "https://mcp.apify.com/?tools=automation-lab/sba-dynamic-small-business-search-scraper" ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-sba-search": { "url": "https://mcp.apify.com/?tools=automation-lab/sba-dynamic-small-business-search-scraper" } } } ``` Example prompts: - "Find 100 SBA small-business roofing suppliers in Virginia." - "Export cybersecurity small-business profiles with UEI and emails." - "Create a CSV of janitorial suppliers for Texas market research." ### Data quality notes The actor exports public data as provided by SBA Small Business Search. Some profiles may not publish every contact field. Phone, email, capability statement, and website coverage varies by supplier. ### Limits and performance The SBA search API returns matching candidates in one response. Use `maxItems` to control how many rows are saved and charged. Very broad searches can return large candidate sets, so specific filters are recommended. ### Legality This actor extracts publicly available business profile information from a public government search service. You are responsible for using the data lawfully and respecting applicable procurement, privacy, email, and outreach rules. ### FAQ #### Is it legal to scrape SBA Small Business Search? The actor collects public supplier profile data. Your use of exported data must still follow applicable laws and outreach rules. #### Can I use this for set-aside supplier discovery? Yes. Combine keywords, state filters, NAICS codes, and certification filters to build targeted supplier lists. ### Troubleshooting #### Why did I get fewer results than expected? Your filters may be too narrow, or SBA may not have matching public profiles for that combination. Try a broader search term or remove state and NAICS filters. #### Why are some contact fields empty? SBA profiles do not always include every contact field. The actor keeps missing values as `null` instead of inventing data. #### Why is a broad search slower? The public SBA endpoint can return thousands of candidates for broad terms. Use precise terms and state filters for faster runs. ### Related scrapers - https://apify.com/automation-lab/samgov-government-contracts-scraper - https://apify.com/automation-lab/gsa-elibrary-contractor-scraper - https://apify.com/automation-lab/uspto-trademark-status-checker - https://apify.com/automation-lab/npi-registry-provider-scraper ### Changelog #### 0.1 Initial version with SBA search API extraction, state filters, NAICS filters, contact fields, capability fields, and profile URLs. ### Support Open an issue on the Apify Store page if the SBA website changes or you need additional fields. ### Output formats Download data as JSON, CSV, Excel, XML, RSS, or HTML from the Apify dataset page. ### Automation ideas Schedule weekly supplier discovery runs for target NAICS codes. Monitor new small-business profiles in a state. Build a CRM import file for GovCon outreach. Compare supplier coverage across multiple states. Enrich bid partner research with public capability narratives. ### Field mapping details `certifications` is derived from public boolean certification flags when present. `businessTypes` is derived from self-certified ownership and small-business flags. `lastUpdateDate` is converted from the SBA timestamp to ISO format. `profileUrl` points back to the public SBA profile when UEI and CAGE code are available. ### Responsible use Avoid unsolicited bulk outreach that violates applicable laws or platform rules. Use the data for legitimate procurement research, supplier discovery, compliance, and analysis. Keep your own suppression lists and outreach governance outside the actor. ### Versioning The actor follows semantic versioning for user-visible changes. Minor updates may add fields or improve filter support. Patch updates fix extraction reliability when the SBA frontend changes. # Actor input Schema ## `searchTerm` (type: `string`): Free-text business, capability, keyword, NAICS, product, or service term to search in SBA Small Business Search. ## `stateCodes` (type: `array`): Optional U.S. state or territory postal codes. Example: VA, TX, CA. ## `naicsCodes` (type: `array`): Optional NAICS codes to filter supplier profiles. ## `primaryNaicsOnly` (type: `boolean`): When NAICS codes are supplied, only match profiles where the code is the primary NAICS. ## `keywords` (type: `array`): Optional capability keywords to combine with the search term. ## `sbaCertificationCodes` (type: `array`): Advanced: raw certification values used by the SBA site, for example 1,4 for 8(a). Leave empty unless you know the SBA code. ## `activeSamOnly` (type: `boolean`): Return only profiles marked active in SAM.gov. ## `includeProfileDetails` (type: `boolean`): Fetch the public profile endpoint for each emitted business. Slower, but can fill extra detail fields when available. ## `maxItems` (type: `integer`): Maximum business profile rows to save to the dataset. ## Actor input object example ```json { "searchTerm": "roofing", "stateCodes": [ "VA" ], "naicsCodes": [], "primaryNaicsOnly": false, "keywords": [], "sbaCertificationCodes": [], "activeSamOnly": false, "includeProfileDetails": false, "maxItems": 20 } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "searchTerm": "roofing", "stateCodes": [ "VA" ], "naicsCodes": [], "primaryNaicsOnly": false, "keywords": [], "sbaCertificationCodes": [], "activeSamOnly": false, "includeProfileDetails": false, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/sba-dynamic-small-business-search-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 = { "searchTerm": "roofing", "stateCodes": ["VA"], "naicsCodes": [], "primaryNaicsOnly": False, "keywords": [], "sbaCertificationCodes": [], "activeSamOnly": False, "includeProfileDetails": False, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/sba-dynamic-small-business-search-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 '{ "searchTerm": "roofing", "stateCodes": [ "VA" ], "naicsCodes": [], "primaryNaicsOnly": false, "keywords": [], "sbaCertificationCodes": [], "activeSamOnly": false, "includeProfileDetails": false, "maxItems": 20 }' | apify call automation-lab/sba-dynamic-small-business-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/sba-dynamic-small-business-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SBA Dynamic Small Business Search Scraper", "description": "Find SBA Small Business Search / DSBS supplier leads with contacts, UEI, CAGE, NAICS, certifications, capabilities, and profile URLs.", "version": "0.1", "x-build-id": "VpNZle7revOuHmrUT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~sba-dynamic-small-business-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-sba-dynamic-small-business-search-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/automation-lab~sba-dynamic-small-business-search-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-sba-dynamic-small-business-search-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/automation-lab~sba-dynamic-small-business-search-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-sba-dynamic-small-business-search-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", "required": [ "searchTerm" ], "properties": { "searchTerm": { "title": "Search term", "type": "string", "description": "Free-text business, capability, keyword, NAICS, product, or service term to search in SBA Small Business Search." }, "stateCodes": { "title": "State / territory codes", "type": "array", "description": "Optional U.S. state or territory postal codes. Example: VA, TX, CA.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Optional NAICS codes to filter supplier profiles.", "items": { "type": "string" } }, "primaryNaicsOnly": { "title": "Primary NAICS only", "type": "boolean", "description": "When NAICS codes are supplied, only match profiles where the code is the primary NAICS.", "default": false }, "keywords": { "title": "Capability keywords", "type": "array", "description": "Optional capability keywords to combine with the search term.", "items": { "type": "string" } }, "sbaCertificationCodes": { "title": "SBA certification codes", "type": "array", "description": "Advanced: raw certification values used by the SBA site, for example 1,4 for 8(a). Leave empty unless you know the SBA code.", "items": { "type": "string" } }, "activeSamOnly": { "title": "Active SAM.gov only", "type": "boolean", "description": "Return only profiles marked active in SAM.gov.", "default": false }, "includeProfileDetails": { "title": "Fetch profile detail pages", "type": "boolean", "description": "Fetch the public profile endpoint for each emitted business. Slower, but can fill extra detail fields when available.", "default": false }, "maxItems": { "title": "Maximum businesses", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum business profile rows to save to the dataset.", "default": 20 } } }, "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 } } } } } } } } } } ```