Med Spa Lead Contact Discovery Actor

Find contactable med spa leads with ICP filtering, rejection reasons, and personalization hooks, without chaining paid actors.

Why This Actor

• Most lead scrapers over-collect and force manual cleanup.
• This actor is built for outreach execution, not raw data volume.
• It prioritizes budget efficiency with probe-first crawling and strict hard caps.
• It outputs evidence-backed fields so you can trust what you send to sales.

What It Does

• Discovers candidate domains from search/directory queries or seed URLs/CSV.
• Runs two-pass crawl:
  • low-cost probe pass
  • deep crawl only when niche + quality gates pass
• Extracts:
  • business email / phone
  • booking/contact URLs
  • locality signals
  • decision-maker hints
  • personalization hooks (pain + messaging context)
• Scores and classifies every lead into:
  • outreachReady
  • needsManualReview
  • rejected (with explicit reasons)

When To Use It

• You need leads to contact today and cannot waste cycles on bad-fit domains.
• You are running cold email / call campaigns and need personalization context.
• You want strict budget control (maxRuntimeSeconds, maxJsRenders, page caps).
• You need a standalone pipeline with no paid actor dependencies.

Output You Get

• Dataset items with full canonical lead records.
• RUN_SUMMARY with efficiency KPIs:
  • pagesPerOutreachReadyLead
  • requestsPerOutreachReadyLead
  • rejection reason distribution
• OUTPUT_CSV for outreach workflows.

Latest Validation Snapshot

Run date: February 9, 2026 (runs/live-run-2026-02-09-03)

• candidatesDiscovered: 2046
• domainsAfterDedupe: 140
• outreachReadyCount (raw): 34
• cleaned outreach list after post-filtering: 33
• email-first contacts: 20
• phone-first contacts: 13

Quick Start

1. Install:

$npm install

2. Run locally:

$npx apify run --input-file config/samples/balanced.json --purge

3. Run PPE revenue profile:

$npx apify run --input-file config/samples/ppe-revenue.json --purge

4. Run PPE smoke profile:

$npx apify run --input-file config/samples/ppe-smoke.json --purge

5. Open outputs:

• storage/key_value_stores/default/RUN_SUMMARY.json
• storage/key_value_stores/default/OUTPUT_CSV.csv

Input Modes

• fast: lowest cost, highest filtering pressure.
• balanced: production default.
• high_precision: deeper crawl for harder domains.

Seed modes:

• seedUrls for direct targets.
• seedCsvText for batch domain ingestion.
• configurable seed column mapping via:
  • seedCsvUrlColumn
  • seedCsvDomainColumn

Credit Protection Controls

• Hard budget governor:
  • maxLeads
  • maxPagesPerDomainProbe
  • maxPagesPerDomainDeep
  • maxRetries
  • maxJsRenders
  • maxRuntimeSeconds
• Static-first extraction and optional JS fallback.
• Low-yield adapter suppression.
• Niche verifier gate before deep crawl.

Pay-Per-Event Monetization (Value-Gated)

• Runtime billing is optional and off by default (billing.enablePaidEvents=false).
• When enabled, the actor charges only for leads that pass strict billing gates:
  • readinessClass=outreachReady
  • icpScore >= billing.minIcpScore
  • qualityScore >= billing.minQualityScore
  • direct contact channel required (if enabled)
  • personalization hook required (if enabled)
• Base event: billing.outreachLeadEventName (default outreach_ready_lead)
• Optional bonus event: billing.decisionMakerEventName (default decision_maker_direct_contact)
• Safety controls:
  • one base charge per leadId per run
  • billing.maxBillableLeads hard cap per run
  • zero charging for rejected/manual-review leads
  • zero charging when actor pricing is not PAY_PER_EVENT
• Billing telemetry is written into RUN_SUMMARY.billingMeta:
  • attempted/successful base and bonus charges
  • skipped counts (not billable, duplicate, cap, charge-limit)
  • top skip reasons

Lead Filtering Logic

• Hard reject gates for non-fit domains.
• ICP + quality scoring before outreachReady.
• Rejection reasons included to speed remediation.
• Suppression-ready flags in output:
  • doNotContact
  • insufficientConsentSignal
  • needsManualReview

Personalization Data for Cold Outreach

Each lead can include:

• serviceSignals
• offerSignals
• bookingFlowSignal
• painSignals
• brandVoiceSnippets
• decisionMakerHints
• personalizationHooks[] with source-backed snippets

Pricing and Listing

• Actor is public in Apify Store.
• Recommended public-store model for high intent buyers: PAY_PER_EVENT.
• Keep monthly listing only if you target agency/enterprise buyers with high run volume.
• Suggested event strategy:
  • low friction base event for outreach-ready lead
  • higher priced bonus event for decision-maker direct contacts
• Reference pricing payload: config/pricing/ppe-event-pricing.json

Compliance

• Discovery and enrichment only.
• No outbound sending is performed by this actor.
• Use lawful contact sourcing and required consent/opt-out handling in your outbound systems.