Beta

Search Businesses

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
GET
/v1/businesses

Search published Businesses by name, US state/city, NAICS sector/code, website URL, or status. A name is optional and supplied filters combine with AND. Location filters match the same published primary location, not necessarily headquarters. Missing, private, or unpublished facts do not match. Results are not a complete census of businesses in a place. Keep filters unchanged when following a cursor, including after an empty page with has_more=true. This read-only route never adds a Business to a Workspace. Send either query or name, never both. naics_vintage requires naics_code. Cross-parameter validation uses x-smb-query-schema; OpenAPI 3.1 parameter schemas alone cannot enforce these rules. Invalid combinations return 400 validation_error.

Query Parameters

query?string

Business name text. Do not send both query and name.

Match^\s*\S[\s\S]+\S\s*$
Length3 <= length <= 200
name?string

Alias for query. Do not send both query and name.

Match^\s*\S[\s\S]+\S\s*$
Length3 <= length <= 200
status?string
Value in"active""closed""inactive""unknown"
state?string

Two-letter US state code or DC, such as IN. Matches the published primary location, not necessarily headquarters. Case-insensitive; territories are not supported.

Match^(?:[Aa][Ll]|[Aa][Kk]|[Aa][Zz]|[Aa][Rr]|[Cc][Aa]|[Cc][Oo]|[Cc][Tt]|[Dd][Ee]|[Dd][Cc]|[Ff][Ll]|[Gg][Aa]|[Hh][Ii]|[Ii][Dd]|[Ii][Ll]|[Ii][Nn]|[Ii][Aa]|[Kk][Ss]|[Kk][Yy]|[Ll][Aa]|[Mm][Ee]|[Mm][Dd]|[Mm][Aa]|[Mm][Ii]|[Mm][Nn]|[Mm][Ss]|[Mm][Oo]|[Mm][Tt]|[Nn][Ee]|[Nn][Vv]|[Nn][Hh]|[Nn][Jj]|[Nn][Mm]|[Nn][Yy]|[Nn][Cc]|[Nn][Dd]|[Oo][Hh]|[Oo][Kk]|[Oo][Rr]|[Pp][Aa]|[Rr][Ii]|[Ss][Cc]|[Ss][Dd]|[Tt][Nn]|[Tt][Xx]|[Uu][Tt]|[Vv][Tt]|[Vv][Aa]|[Ww][Aa]|[Ww][Vv]|[Ww][Ii]|[Ww][Yy])$
city?string

Exact city name at the published US primary location, ignoring case and surrounding whitespace. Combine with state to disambiguate.

Length1 <= length <= 200
naics_code?string

Published primary NAICS code or 2-5 digit prefix. Six digits match exactly. Also accepts the combined sectors 31-33, 44-45, and 48-49. Unknown or unpublished classifications do not match.

Match^(?:[0-9]{2,6}|31-33|44-45|48-49)$
naics_vintage?string

US NAICS edition. Requires naics_code; defaults to 2022 when omitted, and then a 2017 code finds its 2022 businesses.

Value in"1997""2002""2007""2012""2017""2022"
website_url?string

Exact published HTTP(S) website URL after trimming surrounding whitespace. Scheme, path, case, and trailing slash must match; this is not a domain or substring search.

Match^https?://[^\s]+$
Length8 <= length <= 2048
not_a_business?unknown

Places that aren't businesses (bus stops, parking lots, trailheads) are left out by default (false). true: only them. any: both.

Value infalsetrue"false""true""any"
cursor?string

Cursor returned by the previous page.

Match^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$
limit?integer
Range1 <= value <= 100
Default20
fields?array<>

Repeat or comma-separate public Business field names.

Response Body

data[]; page {cursor, has_more}; projection; schema_version; as_of; provenance when permitted.

application/json
  1. response

Anonymous callers receive a preview of up to 20 Businesses without continuation. Signing in through the public MCP OAuth flow also remains preview-only. REST callers with authenticated Workspace authority can request pages of up to 100 Businesses and cursor pagination. Supported Workspace MCP and agent sessions share the same per-principal and per-Workspace discovery allowances; exhausted allowances return 429. Places that are not businesses (bus stops, parking lots, trailheads) are left out by default; set not_a_business to true for only them or any for both.

as_of*smb_v0_operations_search_businesses_response.__local.Timestamp
Formatdate-time
data*array<>
page*
projection*string
request_id*SmbV0OperationsGetBusinessRequestRevision
Length1 <= length <= 200
schema_hash*smb_v0_operations_search_businesses_response.__local.Digest
Match^sha256:[0-9a-f]{64}$
schema_version*string
Length1 <= length <= 100
usage?

Credits this call used, from the same transaction as any charge. 1,000,000 credits = $1.00. Paid fields cost credits only when a value comes back that this Workspace hasn't unlocked; an unlock lasts 12 months.

curl -X GET 'https://example.com/v1/businesses'
{  "as_of": "2019-08-24T14:15:22Z",  "data": [    {      "acquisition": {        "status": "off_market",        "note": "string",        "sellable": true,        "not_sellable_reason": "government",        "listings": [],        "financing": {          "sba": {            "eligible_industry": true,            "max_rate_percent": 0,            "prime_rate_percent": 0,            "rates_as_of": "2019-08-24",            "term_years": 1,            "min_down_percent": 0          },          "example": {            "price": 0,            "down_percent": 0,            "cash_down": 0,            "loan_amount": 0,            "rate_percent": 0,            "term_years": 1,            "monthly_payment": 0,            "annual_debt_service": 0,            "owner_salary": 0,            "cash_left_after_debt": -1000000000000,            "coverage_ratio": -1000,            "lender_minimum": 0,            "meets_lender_minimum": true          }        },        "confidence": 0,        "method": "modeled"      },      "brand": {        "id": "string",        "name": "string",        "type": "franchise",        "website_url": "string",        "location_count": 1,        "franchise": {          "sba": {            "eligible": true,            "code": "string",            "listed_on": "2019-08-24"          },          "initial_fee_usd": {            "low": 0,            "high": 0          },          "royalty_percent": 0,          "marketing_fund_percent": 0,          "total_investment_usd": {            "low": 0,            "high": 0          },          "units": {            "franchised": 0,            "company_owned": 0,            "year": 0          },          "discloses_earnings": true,          "term_years": 1,          "franchising_since": 0,          "disclosure_year": 0        }      },      "certifications": [        "string"      ],      "city": "string",      "closed_on": "2019-08-24",      "community": {        "demographics": {          "tract": {            "total_population": 0,            "median_household_income": 0,            "per_capita_income": 0,            "poverty_rate": 0,            "unemployment_rate": 0,            "bachelors_plus_rate": 0,            "broadband_subscription_rate": 0,            "uninsured_rate": 0,            "limited_english_rate": 0,            "median_age": 0,            "median_home_value": 0,            "owner_occupied_housing_rate": 0,            "vacancy_rate": 0,            "total_housing_units": 0,            "self_employed_rate": 0,            "mean_commute_time": 0,            "year": 2000          },          "zip": {            "total_population": 0,            "median_household_income": 0,            "per_capita_income": 0,            "poverty_rate": 0,            "unemployment_rate": 0,            "bachelors_plus_rate": 0,            "broadband_subscription_rate": 0,            "uninsured_rate": 0,            "limited_english_rate": 0,            "median_age": 0,            "median_home_value": 0,            "owner_occupied_housing_rate": 0,            "vacancy_rate": 0,            "total_housing_units": 0,            "self_employed_rate": 0,            "mean_commute_time": 0,            "year": 2000          },          "county": {            "total_population": 0,            "median_household_income": 0,            "per_capita_income": 0,            "poverty_rate": 0,            "unemployment_rate": 0,            "bachelors_plus_rate": 0,            "broadband_subscription_rate": 0,            "uninsured_rate": 0,            "limited_english_rate": 0,            "median_age": 0,            "median_home_value": 0,            "owner_occupied_housing_rate": 0,            "vacancy_rate": 0,            "total_housing_units": 0,            "self_employed_rate": 0,            "mean_commute_time": 0,            "average_annual_pay": 0,            "year": 2000          }        }      },      "country_code": "US",      "description": "string",      "financials": {        "estimated": {          "revenue": {            "estimate": 0,            "low": 0,            "high": 0          },          "payroll": 0,          "cash_flow": 0,          "confidence": 0,          "year": 2000,          "method": "modeled"        }      },      "founded_on": "2019-08-24",      "hours": "string",      "id": "string",      "legal_entity": {        "type": "llc",        "status": "active",        "good_standing": true      },      "logo": {        "url": "http://example.com",        "method": "researched"      },      "market": {        "owner_age": {          "under_35_percent": 0,          "age_35_to_54_percent": 0,          "age_55_to_64_percent": 0,          "age_65_plus_percent": 0,          "age_55_plus_percent": 0,          "year": 2000        },        "openings_and_closings": {          "opening_rate_percent": 0,          "closing_rate_percent": 0,          "year": 2000        },        "ownership_mix": {          "women_owned_percent": 0,          "minority_owned_percent": 0,          "hispanic_owned_percent": 0,          "veteran_owned_percent": 0,          "year": 2000        },        "competition": {          "same_industry_businesses_county": 0,          "industry_level": "industry",          "per_10k_residents": 0,          "state_per_10k_residents": 0,          "saturation": "underserved",          "method": "counted"        }      },      "naics_code": "string",      "naics_name": "string",      "naics_title": "string",      "naics_vintage": "1997",      "name": "string",      "not_a_business": true,      "operations": {        "sells_online": true,        "online_booking": true,        "serves_at_customer_location": true,        "emergency_service": true,        "free_estimates": true,        "financing_offered": true,        "licensed_insured": true,        "method": "researched"      },      "ownership": {        "legal_name": {          "name": "string",          "method": "researched"        },        "type": {          "family_owned": true,          "family_generation": 2,          "owner_operated": true,          "locally_owned": true,          "veteran_owned": true,          "woman_owned": true,          "minority_owned": true,          "employee_owned": true,          "method": "researched"        },        "succession": {          "owner_age_band": {            "band": "under_35",            "likelihood": 0,            "method": "modeled"          },          "risk": {            "level": "low",            "score": 0,            "confidence": 0,            "method": "modeled"          }        }      },      "place": {        "zip": "string",        "county": "string",        "county_fips": "string",        "census_tract": "string",        "state_fips": "string",        "area_type": "metro",        "metro_area": "string",        "cbsa_code": "string",        "central_county": true,        "opportunity_zone": true,        "tract_income_level": "low"      },      "primary_classification_id": "string",      "primary_location_id": "string",      "public_phone": "string",      "publication_status": "private",      "published_at": "2019-08-24T14:15:22Z",      "record_type": "business",      "service_area": [        "string"      ],      "services": [        "string"      ],      "social_profiles": {        "facebook": "http://example.com",        "instagram": "http://example.com",        "linkedin": "http://example.com",        "x": "http://example.com",        "youtube": "http://example.com",        "tiktok": "http://example.com",        "pinterest": "http://example.com",        "threads": "http://example.com",        "yelp": "http://example.com",        "google": "http://example.com",        "nextdoor": "http://example.com",        "bbb": "http://example.com",        "houzz": "http://example.com",        "angi": "http://example.com",        "thumbtack": "http://example.com",        "tripadvisor": "http://example.com",        "opentable": "http://example.com",        "method": "researched"      },      "state": "string",      "status": "active",      "team": {        "employees": {          "band": "1-4",          "estimate": 1,          "low": 1,          "high": 1,          "confidence": 0,          "method": "modeled"        },        "makeup": {          "full_time": true,          "part_time": true,          "seasonal": true,          "contractors": true,          "hiring": true,          "method": "researched"        }      },      "technology": {        "website": [          "string"        ],        "ecommerce": [          "string"        ],        "crm": [          "string"        ],        "forms": [          "string"        ],        "booking": [          "string"        ],        "field_service": [          "string"        ],        "ordering": [          "string"        ],        "payments": [          "string"        ],        "reviews": [          "string"        ],        "chat": [          "string"        ],        "marketing": [          "string"        ],        "analytics": [          "string"        ],        "advertising": [          "string"        ],        "hiring": [          "string"        ],        "payroll": [          "string"        ],        "method": "researched"      },      "value": {        "estimate": {          "low": 0,          "likely": 0,          "high": 0        },        "currency": "string",        "confidence": 0,        "as_of": "2019-08-24",        "model_version": "string",        "method": "modeled"      },      "website_status": "live",      "website_url": "string",      "years_in_business": {        "band": "0-2",        "estimate": 0,        "confidence": 0,        "method": "modeled"      }    }  ],  "page": {    "cursor": "string",    "has_more": true  },  "projection": "public",  "request_id": "string",  "schema_hash": "string",  "schema_version": "string",  "usage": {    "credits_charged": 0,    "credits_remaining": 0,    "unit": "usd_micro",    "unlocked_until": "2019-08-24T14:15:22Z"  }}