smbcrawldocs

SMB enrichment API. Query any local business and get structured data back.

Getting Started

1. Create an account and get an API key

curl -X POST https://smbcrawl.dev/api/v1/keys \
  -H "Authorization: Bearer <clerk_token>"

2. Make your first enrichment request

curl "https://smbcrawl.dev/api/v1/enrich/basic?business_name=Mikes+Auto+Repair&city=Sidney&state=OH" \
  -H "X-API-KEY: sk_smbcrawl_..."

3. Poll for results (if async)

curl "https://smbcrawl.dev/api/v1/enrich/status/<request_id>"

Authentication

smbcrawl supports two authentication methods:

API Key

Pass your API key in the X-API-KEY header. Free tier includes 50 credits.

x402 (USDC)

Pay per request with USDC on Base. No account needed. Pass payment in the X-PAYMENT header.

Endpoints

EndpointCreditsx402Description
GET /api/v1/enrich/basic1$0.75NAP, website, category, hours, social, reviews
GET /api/v1/enrich/presence5$3.50Basic + directory audit, NAP consistency, presence score
GET /api/v1/enrich/deep15$12.00Presence + tech stack, competitors, content analysis
GET /api/v1/enrich/status/:idFreeFreePoll for async job results
GET /api/v1/healthFreeFreeHealth check
GET /api/v1/schemaFreeFreeOpenAPI 3.1 specification

Query Parameters

ParameterRequiredDescription
business_nameYesBusiness name to search for
city*City (required unless lat/lng provided)
state*Two-letter state code (required unless lat/lng)
phoneNoPhone number (improves match accuracy)
websiteNoWebsite URL (improves match accuracy)
lat, lng*Coordinates (alternative to city/state)