How to Build a Lead Enrichment Tool with a Single API

import requests
from typing import Optional

BASE = "https://rebirthapi.com/api"
HEADERS = {
    "Authorization": "Bearer rb_live_your_key",
    "Content-Type": "application/json"
}

def enrich_and_score(email: str) -> dict:
    """Full pipeline: enrich -> lookup -> audit -> score."""

    # 1. Enrich the email into a profile
    lead = requests.post(f"{BASE}/v1/lead-enrich",
        headers=HEADERS,
        json={"email": email}
    ).json()

    company_name = lead.get("company", {}).get("name")
    if not company_name:
        return {"email": email, "score": 0, "status": "no_company_found"}

    # 2. Look up the company for ratings and location
    biz = requests.post(f"{BASE}/v1/business-lookup",
        headers=HEADERS,
        json={"query": company_name, "limit": 1}
    ).json()

    business = biz["results"][0] if biz.get("results") else {}
    website = business.get("website") or lead.get("company", {}).get("website")

    # 3. Audit their website (if they have one)
    audit = None
    if website:
        audit = requests.post(f"{BASE}/v1/website-audit",
            headers=HEADERS,
            json={"url": website}
        ).json()

    # 4. Score the lead
    score = 0
    signals = []

    # Decision maker?
    title = lead.get("person", {}).get("title", "").lower()
    if any(role in title for role in ["ceo", "cto", "owner", "founder", "vp", "director"]):
        score += 30
        signals.append(f"Decision maker: {lead['person']['title']}")

    # Bad website = needs help
    if audit and audit.get("scores", {}).get("overall", 100) < 60:
        score += 25
        signals.append(f"Poor website (score: {audit['scores']['overall']})")
    elif not website:
        score += 35
        signals.append("No website at all")

    # Low rating = pain point
    rating = business.get("rating", 5)
    if rating and rating < 4.0:
        score += 20
        signals.append(f"Low rating: {rating} stars")

    # Small team = decision maker accessible
    size = lead.get("company", {}).get("size", "")
    if "1-10" in size or "11-50" in size:
        score += 10
        signals.append(f"Small team ({size})")

    priority = "hot" if score >= 50 else "warm" if score >= 25 else "cold"

    return {
        "email": email,
        "person": lead.get("person"),
        "company": lead.get("company"),
        "business_data": business,
        "website_scores": audit.get("scores") if audit else None,
        "score": min(score, 100),
        "priority": priority,
        "signals": signals
    }

# Process a list of leads
emails = [
    "john@smithplumbing.com",
    "sarah@acmedesign.co",
    "mike@bigcorpinc.com"
]

for email in emails:
    result = enrich_and_score(email)
    print(f"{result['priority'].upper():>4} ({result['score']:>3}) "
          f"{email} — {', '.join(result['signals'])}")