Discovery Sources & Provider Health
Pluggable provider adapters (Company Websites, Directories, Government Licensing Rolls, Optional Places, CSV Upload).
CSV / Excel Intake
User-uploaded spreadsheet with candidate business names, websites, and phones.
Custom Website List
User-provided list of company website URLs or domain names.
HVAC Trade Directory (DEMO sample list)
Bundled SAMPLE list for demos only. Returns nothing unless ENABLE_DEMO_SEED_DATA=true. Not live directory data.
State & Municipal Licensing Registry
Live municipal open data (Chicago business licenses). Bundled state-license SAMPLE records are demo-only and appear only if ENABLE_DEMO_SEED_DATA=true.
OpenStreetMap Open Registry (live)
Live query of the free OpenStreetMap Overpass API for HVAC businesses (craft=hvac / shop=hvac). Real records only; coverage depends on community mapping.
Tavily Search API (Real-Time Web Discovery)Key Required
Real-time AI-optimized web search engine for discovering active HVAC contractor domains, websites, and public local listings.
Google Places API (New)Key Required
Optional Google Places text search adapter with field masks, strict request budgeting, and retention notices.
Apollo B2B Search (Optional Adapter)Key Required
Commercial B2B company and organization search API.