{ "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 } } } } } } } } } }