# SBA Certified Small Business & Federal Contractor Lookup (`dataspryva/sba-certified-small-business-and-federal`) Actor

Search the SBA's public small business directory by name, state, NAICS code, or federal certification (8(a), HUBZone, WOSB, VOSB, SDVOSB) and get contact info, NAICS codes, and certification status.

- **URL**: https://apify.com/dataspryva/sba-certified-small-business-and-federal.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Lead generation, Automation, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SBA Certified Small Business & Federal Contractor Lookup

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 | – (prefill `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` | string / string / int / string | – | Extra client-side post-filters |
| `requireWebsite` | bool | `false` | Only keep records that have a public website URL |
| `maxItems` | int | `25` | Hard cap on emitted records (1-5000) |

> 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.

**How many results can one run return?** Up to `maxItems` (maximum 5,000). The SBA endpoint returns the complete match set in a single response, so the actor streams it and stops as soon as `maxItems` records are collected — there is no server-side page cursor to resume. For lists larger than 5,000, partition the query (for example by state, NAICS sector, or certification) and run each slice separately; results are de-duplicated by SBA entity ID within a run.

**Can I search the entire directory with no filters?** No. The directory contains millions of profiles, so the actor requires at least one narrowing criterion (keyword, location, NAICS, certification, keyword tag, recency, bonding minimum, or active-SAM flag) and tells you which ones are accepted instead of attempting a full-table scan.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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("dataspryva/sba-certified-small-business-and-federal").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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("dataspryva/sba-certified-small-business-and-federal").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 dataspryva/sba-certified-small-business-and-federal --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/sba-certified-small-business-and-federal"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/c7ybk5OIC4jonNcQ6/builds/9hgZg2mav85zuskvr/openapi.json
