# Changelog of Home Services Lead Finder - HVAC, Plumbing, Roofing (`seibs.co/home-services-lead-finder`) Actor

- **URL**: https://apify.com/seibs.co/home-services-lead-finder/changelog.md
- **Full Actor documentation**: https://apify.com/seibs.co/home-services-lead-finder.md

## Changelog

### 0.3 - One record per contractor, and runs that finish

- Cross-search dedupe: a contractor found by several search terms (for example 'HVAC contractors' and 'air conditioning repair') is returned and charged once. Each record lists every search that matched it in `matched_searches`.
- Transient Google Maps upstream errors are retried automatically (up to 3 attempts); an account memory-limit rejection is retried with a smaller upstream run.
- Runs finish inside their timeout: the Maps search and premium website enrichment are time-boxed against the run's deadline. Contractors whose website check is cut short are still delivered with their Maps data (`enrichment_skipped_reason: run_time_limit`, base charge only). Each website check is capped at 40 seconds.
- Clear run status on every outcome: a summary on success, and on an empty run the exact reason (no Maps results, all removed as national chains or outside the selected service lines, software filters matched nothing, account credit/memory limit) plus an uncharged notice record. No more failed runs for these cases.
- More than 50 term x location searches runs the first whole locations and lists the skipped ones for the next run, instead of failing. Blank lines in the term/location lists are ignored.

### 0.2 - Tech-gap qualification

- Every premium record now carries `tech_gap` (no field-service software detected -> greenfield prospect), `has_core_software` (runs an FSM platform -> displacement target), and `software_detected` (exact platform ids found)
- New premium filters: `only_tech_gap` (greenfield only), `required_tech` (keep firms on a given platform), `excluded_tech` (drop firms already on listed platforms) - filtered records are never charged
- 32 core field-service platforms classify the gap; marketing/review/CMS/call-tracking tools (WordPress, HubSpot, CallRail, Podium, NiceJob, ...) deliberately do not clear it
- Turns a raw lead list into a pre-qualified prospect list for FSM software sales and competitive displacement

### 0.1 - Initial release

- Google Maps lead extraction for HVAC, plumbing, electrical, roofing, solar, garage door, pest control, landscaping
- Three enrichment tiers: base, email, premium
- Tech stack detection (ServiceTitan, Housecall Pro, Jobber, FieldEdge, Workiz, Service Fusion, etc.)
- License number extraction across 27 states
- BBB accreditation, 24/7 service, year founded, fleet hints, owner names, employee count
- Schema.org JSON-LD parsing
- Role-bucketed emails (sales, support, billing, hr, executive, marketing)
- Online booking, chatbot, email marketing, lead-capture CTA, mobile app, certification, financing detection
- Pay-per-event pricing
- Dataset overview view, detailed view, output schema