🎯 Lead Scoring API Documentation

📖 Overview

The Lead Scoring API enriches identity data with intelligent scoring for home renovation sales.

Key Features

• ✨ 100-Point Scoring System across 5 categories
• 🎯 Tier Classification: A (Hot), B (Warm), C (Cold), D (Do Not Call)
• 🏠 Product Recommendations: Windows, Roofing, Siding, Bathroom, Doors
• 🔄 Automatic Retry Logic with exponential backoff
• 💬 Sales Talking Points for every lead

🚀 Quick Start

Test the API Now

curl "https://enhance-data-production.up.railway.app/phone?phone=+16178884144&lead_score=true"

Response Preview

{
  "score": { "total": 87, "tier": "A", "call_priority": 1 },
  "breakdown": {
    "home_ownership": 35,
    "financial_capacity": 24,
    "property_age": 20
  },
  "products": {
    "recommended_products": [
      {
        "product": "Windows",
        "priority": "High",
        "estimated_budget": "$8K-$25K"
      }
    ]
  }
}

🔌 API Endpoints

• GET /phone?phone={number}&lead_score=true - Phone lookup with scoring
• GET /email?email={email}&lead_score=true - Email lookup with scoring
• GET /address?address={address}&lead_score=true - Address lookup with scoring
• GET /health - API health check

🎯 Tier Classification

📊 Scoring System (100 Points)

• Home Ownership & Property Value: 35 points
  • Homeowner: 15 pts | Property $500K+: 20 pts
• Financial Capacity: 30 points
  • Income $150K+: 15 pts | Credit 750+: 15 pts
• Property Age: 20 points
  • Built pre-1980: 15 pts | Single family: 5 pts
• Improvement Indicators: 10 points
• Contact Quality: 5 points

📚 Complete Documentation

For detailed API reference, ASCII diagrams, integration guides, and more: