# SBA Small Business Search Scraper (`crawlerbros/sba-small-business-search-scraper`) Actor Search the U.S. Small Business Administration's public business directory by name, US state, NAICS industry code, or federal certification (8(a), HUBZone, WOSB, EDWOSB, VOSB, SDVOSB). Get contact info, NAICS codes, capabilities, and certification status for millions of registered small businesses. - **URL**: https://apify.com/crawlerbros/sba-small-business-search-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (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 from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Small Business Search Scraper Search the [U.S. Small Business Administration's public Small Business Search directory](https://search.certifications.sba.gov) — the official federal tool used by contracting officers and buyers to find small businesses. Search by business name, keyword, UEI, or CAGE code; browse by US state, NAICS industry code, or federal certification (8(a), HUBZone, WOSB, EDWOSB, VOSB, SDVOSB). No login, no cookies, no proxy required — this is a fully public government dataset. ### What this actor does - **Four modes:** `search`, `byState`, `byNaicsCode`, `byCertification` - **All 50 US states + DC + 8 territories** available as location filters - **Metro area (MSA), county, and congressional district filters** for precise geographic targeting - **All 6 SBA federal certification programs** available as filters - **11 self-certified business types** (minority-owned, tribally-owned, ANC/NHO-owned, etc.) as a filter - **5 quality assurance standards** (ANSI, ISO 9000, ISO 10012, MIL-Q, MIL-STD) as a filter - **Bonding-level minimums** (construction/service, individual/aggregate) to find businesses that can bond above a dollar threshold - **Exact keyword-tag filter**, distinct from free-text search, plus a "profile last updated" recency filter - **24 top-level NAICS industry sectors** as a curated filter, plus free-text exact NAICS code input - Returns contact info, address, NAICS codes, capabilities narrative, self-reported business classifications (minority/woman/veteran-owned, etc.), and active federal certifications - Respects each business's own contact-visibility settings — only returns phone/email/fax/address when the business opted to display it publicly - Empty fields are omitted — every record only contains data that was actually found ### Output per business - `entityId`, `legalBusinessName`, `dbaName`, `uei`, `cageCode` - `primaryNaicsCode`, `naicsCodes[]`, `keywords[]` - `capabilitiesNarrative`, `capabilitiesLink`, `principals`, `contactPerson` - `phone`, `fax`, `email`, `website`, `additionalWebsite` - `streetAddress`, `city`, `state`, `zipCode`, `county`, `congressionalDistrict`, `msa` - `yearEstablished`, `businessSizeEmployees`, `annualRevenueUsd` - `isExporter`, `exportBusinessActivities`, `exportToCountries`, `desiredExportRelationships`, `exportObjective` - `activeFederalCertifications[]` — e.g. `["8(a)", "HUBZone"]` - `selfCertifications[]` — e.g. `["Woman-Owned Small Business", "Veteran-Owned", "Hispanic American Owned"]` - `nonFederalCertifications` — free-text non-federal/professional certifications self-reported by the business, e.g. `"WBENC; PSWMSDC - MBE"` - `qualityStandards[]`, `bondingLevelsUsd`, `isActiveSam`, `lastUpdatedAt` - `sourceUrl`, `recordType: "smallBusiness"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `byState` / `byNaicsCode` / `byCertification` | | `searchTerm` | string | `bakery` | Business name, UEI, CAGE code, or keyword | | `states` | array | – | US states/territories to restrict to (mode=byState) | | `zipCodes` | array | – | 5-digit ZIP codes to restrict to | | `naicsSector` | string | – | Top-level NAICS industry sector (mode=byNaicsCode) | | `naicsCodes` | array | – | Exact 2-6 digit NAICS codes (mode=byNaicsCode) | | `naicsPrimaryOnly` | bool | `false` | Match only businesses whose *primary* NAICS is in the list | | `certifications` | array | – | SBA certification programs to restrict to (mode=byCertification) | | `includePreviousCertifications` | bool | `false` | Include lapsed/suspended certifications | | `activeSamOnly` | bool | `false` | Only businesses with an active SAM.gov registration | | `msaCodes` | array | – | 5-digit metro area (MSA/CBSA) codes, e.g. `12420` | | `countyFips` | array | – | 5-digit US county FIPS codes, e.g. `48453` | | `congressionalDistricts` | array | – | US congressional districts, e.g. `TX-21`, `Wyoming-00` | | `selfCertifications` | array | – | Self-attested SAM.gov business types (not SBA-verified) | | `qualityStandards` | array | – | Quality assurance certifications (ANSI, ISO 9000, ISO 10012, MIL-Q, MIL-STD) | | `minConstructionBondingIndividual` / `minConstructionBondingAggregate` / `minServiceBondingIndividual` / `minServiceBondingAggregate` | int | – | Minimum bonding-capacity thresholds (USD) | | `keywords` | array | – | Exact keyword/capability tags to match (OR'd, distinct from `searchTerm`) | | `lastUpdated` | string | `anytime` | Only businesses updated within `past-3-months` / `past-6-months` / `past-year` | | `stateFilter` / `naicsPrefixFilter` / `minYearEstablished` / `certificationFilter` / `requireWebsite` | – | – | Extra client-side post-filters | | `maxItems` | int | `25` | Hard cap on emitted records (1-500) | > Location filters (`states`, `zipCodes`, `msaCodes`, `countyFips`, `congressionalDistricts`) are combined with OR logic — a business matching *any* of them is included. #### Example: HUBZone-certified construction firms in Texas ```json { "mode": "byCertification", "certifications": ["HUBZONE"], "states": ["TX"], "searchTerm": "construction", "maxItems": 50 } ```` #### Example: browse a NAICS industry sector ```json { "mode": "byNaicsCode", "searchTerm": "restaurant", "naicsSector": "72", "states": ["CA"], "maxItems": 100 } ``` > `naicsSector` is a convenience *refinement* filter (applied client-side against each business's actual NAICS codes) rather than a precise server-side search axis — the SBA API only supports exact-code matching, not sector-level prefixes. For best results, pair it with `searchTerm`, `naicsCodes` (exact codes), `states`, or `certifications` so the initial search is already reasonably narrow. #### Example: woman-owned businesses with a website ```json { "mode": "byCertification", "certifications": ["WOSB", "EDWOSB"], "requireWebsite": true, "maxItems": 50 } ``` #### Example: bondable construction firms in a specific metro area ```json { "mode": "search", "searchTerm": "construction", "msaCodes": ["12420"], "minConstructionBondingIndividual": 50000, "qualityStandards": ["ANSI"], "maxItems": 50 } ``` #### Example: recently-updated minority-owned businesses in a county ```json { "mode": "search", "searchTerm": "consulting", "countyFips": ["48453"], "selfCertifications": ["SELF_SDB"], "lastUpdated": "past-6-months", "maxItems": 50 } ``` ### Use cases - **Federal contracting** — find certified small-business subcontractors/vendors for a solicitation - **Supplier diversity programs** — source minority-, woman-, or veteran-owned suppliers by industry and location - **Sales prospecting** — build a targeted list of small businesses in a specific NAICS sector and state - **Market research** — analyze the density of certified small businesses by industry/region - **Partnership sourcing** — find potential joint-venture partners holding a specific SBA certification ### FAQ **What is SBA Small Business Search?** The official U.S. Small Business Administration tool (search.certifications.sba.gov) that federal agencies and prime contractors use to find small businesses — especially those with SBA certifications — for contracting opportunities. **What are the SBA certifications?** Federal socio-economic contracting programs: **8(a)** (disadvantaged business), **HUBZone** (historically underutilized business zone), **WOSB**/**EDWOSB** (woman-owned / economically disadvantaged woman-owned), and **VOSB**/**SDVOSB** (veteran-owned / service-disabled veteran-owned). **What's the difference between `activeFederalCertifications` and `selfCertifications`?** `activeFederalCertifications` are SBA-verified certifications requiring a formal application. `selfCertifications` are self-reported classifications (e.g. "Minority-Owned Business", "Hispanic American Owned") that aren't independently verified by SBA. **Why do some businesses have no phone/email/address?** Each business controls whether its contact details are shown publicly. The actor only returns fields the business itself opted to display. **What are UEI and CAGE code?** A **UEI** (Unique Entity Identifier) and **CAGE code** (Commercial and Government Entity code) are federal identifiers assigned when a business registers in SAM.gov — both are searchable via `searchTerm`. **How current is this data?** SBA updates records continuously as businesses register, renew certifications, or update their profiles; `lastUpdatedAt` reflects the business's own last profile update. **What's the difference between `keywords` and `searchTerm`?** `searchTerm` is a broad free-text match across the business name, capabilities narrative, and tags. `keywords` is an exact (case-insensitive) match against a business's structured keyword/capability tags only, and multiple keywords are OR-matched — useful for precise tag-based filtering rather than broad text search. **What are self-certifications vs. quality assurance standards?** Self-certifications are ownership-trait attestations businesses make in SAM.gov (e.g. "Native American Owned") — not independently verified by SBA. Quality assurance standards (ANSI, ISO 9000, ISO 10012, MIL-Q, MIL-STD) are quality-management certifications a business reports holding. **How do I find an MSA code, county FIPS code, or congressional district?** MSA (metro area) codes and county FIPS codes are standard 5-digit US Census Bureau identifiers — look them up on Census.gov, or via the SBA's own Advanced Search "Metropolitan statistical area" / "Congressional district and county code list" reference tools. Congressional districts use the format `State-##` (e.g. `Texas-21`); at-large single-district states use `-00` and DC/Puerto Rico/Guam/US Virgin Islands/American Samoa/Northern Mariana Islands use `-98`. **Can I filter by employee count or annual revenue?** No — while the upstream search tool's data model includes these fields, they are not enforced as filters server-side (confirmed by testing) and the live search UI has no controls for them either, so this actor does not expose them to avoid a filter that silently does nothing. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchTerm` (type: `string`): Business name, UEI, CAGE code, or keyword (matches capabilities narrative and tags too). Note: SBA's own search does raw substring matching across a large free-text narrative field, not word-boundary matching — a common term (e.g. "bakery") can surface loosely-related businesses whose name or narrative merely contains a similar-looking substring (e.g. a firm with "Baker" in its name). This is an upstream search-relevance characteristic, not something this actor filters — for precise results, combine with `states`/`naicsCodes`/`certifications`. ## `states` (type: `array`): Restrict results to businesses located in these states/territories. ## `zipCodes` (type: `array`): Restrict results to these 5-digit ZIP codes. ## `naicsSector` (type: `string`): Top-level industry sector to browse. Applied as a client-side refinement (the upstream API only exact-matches NAICS codes) — pair with `searchTerm`, `naicsCodes`, `states`, or `certifications` for a well-narrowed search. ## `naicsCodes` (type: `array`): Precise 2-6 digit NAICS codes (e.g. `722310` for food-service contractors). Combine with `naicsSector` for a broader net. ## `naicsPrimaryOnly` (type: `boolean`): Only match businesses whose PRIMARY NAICS code is in the given list (instead of any of their listed codes). ## `certifications` (type: `array`): Restrict to businesses holding one of these active SBA certifications. ## `includePreviousCertifications` (type: `boolean`): Also include businesses whose certification has since expired or been suspended. ## `activeSamOnly` (type: `boolean`): Only return businesses with an active federal SAM.gov registration. ## `msaCodes` (type: `array`): Restrict results to these 5-digit Census metropolitan statistical area (MSA/CBSA) codes, e.g. `12420` for Austin-Round Rock-San Marcos, TX. Look up codes on the Census Bureau's CBSA delineation file or via the SBA's own Advanced Search 'Metropolitan statistical area' picker. ## `countyFips` (type: `array`): Restrict results to these 5-digit US county FIPS codes (2-digit state + 3-digit county), e.g. `48453` for Travis County, TX. Look up codes on the Census Bureau's county FIPS reference. ## `congressionalDistricts` (type: `array`): Restrict results to these US congressional districts, e.g. `TX-21` or `Texas-21`. Use `-00` for at-large single-district states (e.g. `Wyoming-00`) and `-98` for the non-voting delegate districts of DC, Puerto Rico, Guam, the US Virgin Islands, American Samoa, and the Northern Mariana Islands. ## `selfCertifications` (type: `array`): Restrict to businesses that self-attested to these ownership traits in SAM.gov. These are not independently verified by SBA (unlike the federal `certifications` above). ## `qualityStandards` (type: `array`): Restrict to businesses that hold these quality assurance certifications. ## `minConstructionBondingIndividual` (type: `integer`): Only return businesses whose reported individual/per-contract construction bonding capacity is at least this many US dollars. ## `minConstructionBondingAggregate` (type: `integer`): Only return businesses whose reported aggregate construction bonding capacity is at least this many US dollars. ## `minServiceBondingIndividual` (type: `integer`): Only return businesses whose reported individual/per-contract service bonding capacity is at least this many US dollars. ## `minServiceBondingAggregate` (type: `integer`): Only return businesses whose reported aggregate service bonding capacity is at least this many US dollars. ## `keywords` (type: `array`): Restrict to businesses tagged with any of these exact keyword/capability tags (case-insensitive exact match, OR'd together). This is distinct from `searchTerm`, which does a broader free-text match across name/narrative/tags. ## `lastUpdated` (type: `string`): Only include businesses whose profile was last updated within this time window. ## `stateFilter` (type: `string`): Extra client-side filter: drop records not located in this state (2-letter code or full name). Useful alongside other modes. ## `naicsPrefixFilter` (type: `string`): Extra client-side filter: only keep records with a NAICS code starting with this prefix. ## `minYearEstablished` (type: `integer`): Drop businesses established before this year. ## `certificationFilter` (type: `string`): Extra client-side filter: only keep records with this active certification. ## `requireWebsite` (type: `boolean`): Only keep records that have a public website URL. ## `maxItems` (type: `integer`): Hard cap on emitted business records. ## Actor input object example ```json { "mode": "search", "searchTerm": "bakery", "states": [], "zipCodes": [], "naicsCodes": [], "naicsPrimaryOnly": false, "certifications": [], "includePreviousCertifications": false, "activeSamOnly": false, "msaCodes": [], "countyFips": [], "congressionalDistricts": [], "selfCertifications": [], "qualityStandards": [], "keywords": [], "lastUpdated": "anytime", "requireWebsite": false, "maxItems": 25 } ``` # Actor output Schema ## `businesses` (type: `string`): Dataset containing all scraped small-business records. # 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 = { "mode": "search", "searchTerm": "bakery", "zipCodes": [], "naicsCodes": [], "naicsPrimaryOnly": false, "includePreviousCertifications": false, "activeSamOnly": false, "msaCodes": [], "countyFips": [], "congressionalDistricts": [], "keywords": [], "lastUpdated": "anytime", "requireWebsite": false, "maxItems": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/sba-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 = { "mode": "search", "searchTerm": "bakery", "zipCodes": [], "naicsCodes": [], "naicsPrimaryOnly": False, "includePreviousCertifications": False, "activeSamOnly": False, "msaCodes": [], "countyFips": [], "congressionalDistricts": [], "keywords": [], "lastUpdated": "anytime", "requireWebsite": False, "maxItems": 25, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/sba-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 '{ "mode": "search", "searchTerm": "bakery", "zipCodes": [], "naicsCodes": [], "naicsPrimaryOnly": false, "includePreviousCertifications": false, "activeSamOnly": false, "msaCodes": [], "countyFips": [], "congressionalDistricts": [], "keywords": [], "lastUpdated": "anytime", "requireWebsite": false, "maxItems": 25 }' | apify call crawlerbros/sba-small-business-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/sba-small-business-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SBA Small Business Search Scraper", "description": "Search the U.S. Small Business Administration's public business directory by name, US state, NAICS industry code, or federal certification (8(a), HUBZone, WOSB, EDWOSB, VOSB, SDVOSB). Get contact info, NAICS codes, capabilities, and certification status for millions of registered small businesses.", "version": "1.0", "x-build-id": "AsBFtWEhFYvb3zGQ5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~sba-small-business-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-sba-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/crawlerbros~sba-small-business-search-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-sba-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/crawlerbros~sba-small-business-search-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-sba-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byState", "byNaicsCode", "byCertification" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchTerm": { "title": "Search term", "type": "string", "description": "Business name, UEI, CAGE code, or keyword (matches capabilities narrative and tags too). Note: SBA's own search does raw substring matching across a large free-text narrative field, not word-boundary matching — a common term (e.g. \"bakery\") can surface loosely-related businesses whose name or narrative merely contains a similar-looking substring (e.g. a firm with \"Baker\" in its name). This is an upstream search-relevance characteristic, not something this actor filters — for precise results, combine with `states`/`naicsCodes`/`certifications`.", "default": "bakery" }, "states": { "title": "US states (mode=byState)", "uniqueItems": true, "type": "array", "description": "Restrict results to businesses located in these states/territories.", "items": { "type": "string", "enum": [ "AL", "AK", "AS", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FM", "FL", "GA", "GU", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MH", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "MP", "OH", "OK", "OR", "PW", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "VI", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama (AL)", "Alaska (AK)", "American Samoa (AS)", "Arizona (AZ)", "Arkansas (AR)", "California (CA)", "Colorado (CO)", "Connecticut (CT)", "Delaware (DE)", "District of Columbia (DC)", "Federated States of Micronesia (FM)", "Florida (FL)", "Georgia (GA)", "Guam (GU)", "Hawaii (HI)", "Idaho (ID)", "Illinois (IL)", "Indiana (IN)", "Iowa (IA)", "Kansas (KS)", "Kentucky (KY)", "Louisiana (LA)", "Maine (ME)", "Marshall Islands (MH)", "Maryland (MD)", "Massachusetts (MA)", "Michigan (MI)", "Minnesota (MN)", "Mississippi (MS)", "Missouri (MO)", "Montana (MT)", "Nebraska (NE)", "Nevada (NV)", "New Hampshire (NH)", "New Jersey (NJ)", "New Mexico (NM)", "New York (NY)", "North Carolina (NC)", "North Dakota (ND)", "Northern Mariana Islands (MP)", "Ohio (OH)", "Oklahoma (OK)", "Oregon (OR)", "Palau (PW)", "Pennsylvania (PA)", "Puerto Rico (PR)", "Rhode Island (RI)", "South Carolina (SC)", "South Dakota (SD)", "Tennessee (TN)", "Texas (TX)", "Utah (UT)", "Vermont (VT)", "Virginia (VA)", "U.S. Virgin Islands (VI)", "Washington (WA)", "West Virginia (WV)", "Wisconsin (WI)", "Wyoming (WY)" ] }, "default": [] }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Restrict results to these 5-digit ZIP codes.", "default": [], "items": { "type": "string" } }, "naicsSector": { "title": "NAICS sector (mode=byNaicsCode)", "enum": [ "11", "21", "22", "23", "31", "32", "33", "42", "44", "45", "48", "49", "51", "52", "53", "54", "55", "56", "61", "62", "71", "72", "81", "92" ], "type": "string", "description": "Top-level industry sector to browse. Applied as a client-side refinement (the upstream API only exact-matches NAICS codes) — pair with `searchTerm`, `naicsCodes`, `states`, or `certifications` for a well-narrowed search." }, "naicsCodes": { "title": "Exact NAICS codes (mode=byNaicsCode)", "type": "array", "description": "Precise 2-6 digit NAICS codes (e.g. `722310` for food-service contractors). Combine with `naicsSector` for a broader net.", "default": [], "items": { "type": "string" } }, "naicsPrimaryOnly": { "title": "Match primary NAICS only", "type": "boolean", "description": "Only match businesses whose PRIMARY NAICS code is in the given list (instead of any of their listed codes).", "default": false }, "certifications": { "title": "Federal certifications (mode=byCertification)", "uniqueItems": true, "type": "array", "description": "Restrict to businesses holding one of these active SBA certifications.", "items": { "type": "string", "enum": [ "8A", "HUBZONE", "WOSB", "EDWOSB", "VOSB", "SDVOSB" ], "enumTitles": [ "8(a) or 8(a) Joint Venture", "HUBZone", "Women-Owned Small Business (WOSB)", "Economically-Disadvantaged Women-Owned Small Business (EDWOSB)", "Veteran-Owned Small Business (VOSB)", "Service-Disabled Veteran-Owned Small Business (SDVOSB)" ] }, "default": [] }, "includePreviousCertifications": { "title": "Include lapsed/previous certifications", "type": "boolean", "description": "Also include businesses whose certification has since expired or been suspended.", "default": false }, "activeSamOnly": { "title": "Active SAM.gov registration only", "type": "boolean", "description": "Only return businesses with an active federal SAM.gov registration.", "default": false }, "msaCodes": { "title": "Metro areas (MSA/CBSA codes)", "type": "array", "description": "Restrict results to these 5-digit Census metropolitan statistical area (MSA/CBSA) codes, e.g. `12420` for Austin-Round Rock-San Marcos, TX. Look up codes on the Census Bureau's CBSA delineation file or via the SBA's own Advanced Search 'Metropolitan statistical area' picker.", "default": [], "items": { "type": "string" } }, "countyFips": { "title": "Counties (5-digit FIPS codes)", "type": "array", "description": "Restrict results to these 5-digit US county FIPS codes (2-digit state + 3-digit county), e.g. `48453` for Travis County, TX. Look up codes on the Census Bureau's county FIPS reference.", "default": [], "items": { "type": "string" } }, "congressionalDistricts": { "title": "US congressional districts", "type": "array", "description": "Restrict results to these US congressional districts, e.g. `TX-21` or `Texas-21`. Use `-00` for at-large single-district states (e.g. `Wyoming-00`) and `-98` for the non-voting delegate districts of DC, Puerto Rico, Guam, the US Virgin Islands, American Samoa, and the Northern Mariana Islands.", "default": [], "items": { "type": "string" } }, "selfCertifications": { "title": "Self-certifications (SAM.gov, non-federal)", "uniqueItems": true, "type": "array", "description": "Restrict to businesses that self-attested to these ownership traits in SAM.gov. These are not independently verified by SBA (unlike the federal `certifications` above).", "items": { "type": "string", "enum": [ "SELF_SDB", "SELF_HUBZONE_JV", "SELF_VOSB", "SELF_WOSB", "SELF_WOSB_JV", "SELF_CDC", "SELF_NATIVE_AMERICAN", "SELF_TRIBALLY_OWNED", "SELF_AMERICAN_INDIAN", "SELF_ANC", "SELF_NHO" ], "enumTitles": [ "Self-Certified Small Disadvantaged Business", "Self-Certified HUBZone Joint Venture", "Self-Certified Veteran-Owned Small Business", "Self-Certified Woman-Owned Small Business", "Self-Certified Woman-Owned Small Business Joint Venture", "Community Development Corporation (CDC) Owned Small Business", "Native American Owned", "Tribally Owned Small Business", "American Indian Owned Small Business", "Alaskan Native Corp (ANC) Owned Small Business", "Native Hawaiian Org (NHO) Owned Small Business" ] }, "default": [] }, "qualityStandards": { "title": "Quality assurance standards", "uniqueItems": true, "type": "array", "description": "Restrict to businesses that hold these quality assurance certifications.", "items": { "type": "string", "enum": [ "ANSI", "ISO_9000", "ISO_10012", "MIL_Q", "MIL_STD" ], "enumTitles": [ "ANSI/ASQC Z1.4", "ISO 9000 Series", "ISO 10012-1", "MIL-Q-9858", "MIL-STD-45662A" ] }, "default": [] }, "minConstructionBondingIndividual": { "title": "Min construction bonding level (per-contract, USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only return businesses whose reported individual/per-contract construction bonding capacity is at least this many US dollars." }, "minConstructionBondingAggregate": { "title": "Min construction bonding level (aggregate, USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only return businesses whose reported aggregate construction bonding capacity is at least this many US dollars." }, "minServiceBondingIndividual": { "title": "Min service bonding level (per-contract, USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only return businesses whose reported individual/per-contract service bonding capacity is at least this many US dollars." }, "minServiceBondingAggregate": { "title": "Min service bonding level (aggregate, USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only return businesses whose reported aggregate service bonding capacity is at least this many US dollars." }, "keywords": { "title": "Keyword tags (exact match, OR-matched)", "type": "array", "description": "Restrict to businesses tagged with any of these exact keyword/capability tags (case-insensitive exact match, OR'd together). This is distinct from `searchTerm`, which does a broader free-text match across name/narrative/tags.", "default": [], "items": { "type": "string" } }, "lastUpdated": { "title": "Profile last updated within", "enum": [ "anytime", "past-3-months", "past-6-months", "past-year" ], "type": "string", "description": "Only include businesses whose profile was last updated within this time window.", "default": "anytime" }, "stateFilter": { "title": "Post-filter: state", "type": "string", "description": "Extra client-side filter: drop records not located in this state (2-letter code or full name). Useful alongside other modes." }, "naicsPrefixFilter": { "title": "Post-filter: NAICS code prefix", "type": "string", "description": "Extra client-side filter: only keep records with a NAICS code starting with this prefix." }, "minYearEstablished": { "title": "Post-filter: min year established", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Drop businesses established before this year." }, "certificationFilter": { "title": "Post-filter: certification", "enum": [ "8A", "HUBZONE", "WOSB", "EDWOSB", "VOSB", "SDVOSB" ], "type": "string", "description": "Extra client-side filter: only keep records with this active certification." }, "requireWebsite": { "title": "Require a website", "type": "boolean", "description": "Only keep records that have a public website URL.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted business records.", "default": 25 } } }, "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 } } } } } } } } } } ```