Real Estate Data + Skip Tracing API. Pay Per Hit.

# Property Snapshot — 50+ property fields PLUS owner contact in one call.

# 1. Send the request:
curl https://tracerfy.com/v1/api/lead-builder/lookup/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "4521 E Monte Cristo Ave",
    "city":    "Phoenix",
    "state":   "AZ",
    "zip":     "85032"
  }'

# 2. Full response — typically 1-2 seconds:
{
  "hit":              true,
  "credits_deducted": 10,
  "skip_trace_hit":   true,
  "property": {
    // Location
    "address":    "4521 E Monte Cristo Ave",
    "city":       "Phoenix",
    "state":      "AZ",
    "zip_code":   "85032",
    "county":     "Maricopa",
    "apn":        "123-45-6789",
    // Structure
    "property_type":      "SFR",
    "year_built":         1978,
    "beds":               4,
    "baths":              2.5,
    "building_size_sqft": 2140,
    "lot_size_sqft":      8712,
    "stories":            1,
    "has_garage":         true,
    "has_pool":           false,
    "roof_material":      "Composition Shingle",
    "flood_zone":         false,
    // Value & equity
    "estimated_value":       485000,
    "estimated_equity":      298000,
    "equity_percent":        61.4,
    "open_mortgage_balance": 134500,
    "lender_name":          "Wells Fargo",
    "last_sale_date":       "2014-06-12",
    "last_sale_price":      245000,
    "years_owned":          12,
    // Strategy / distress flags
    "absentee_owner":  false,
    "owner_occupied": true,
    "high_equity":    true,
    "free_clear":     false,
    "pre_foreclosure": false,
    "tax_delinquent":  false,
    "vacant":          false,
    "inherited":       false,
    // Propensity scores (0-100) + categories
    "sell_propensity_score":            76,
    "sell_propensity_category":         "High",
    "refi_propensity_score":            64,
    "refi_propensity_category":         "Medium",
    "roof_renovate_propensity_score":   82,
    "hvac_renovate_propensity_score":   58,
    "solar_renovate_propensity_score":  55
  },
  "owners": [
    { "first_name": "JANET",  "last_name": "MORRIS" },
    { "first_name": "ROBERT", "last_name": "MORRIS" }
  ],
  "mailing_address": {
    "address": "4521 E Monte Cristo Ave",
    "city":    "Phoenix", "state": "AZ", "zip": "85032"
  },
  "contacts": {
    "phones": [
      { "number": "4805551234", "type": "Mobile",
        "carrier": "T-Mobile", "dnc": false, "tcpa": false, "rank": 1 },
      { "number": "4805559876", "type": "Mobile",
        "carrier": "AT&T", "dnc": true, "tcpa": false, "rank": 2 }
    ],
    "emails": [
      { "email": "[email protected]", "rank": 1 }
    ],
    "litigator":     false,
    "has_contact":   true,
    "contact_clean": false
  }
}

# Tip: high equity + absentee owner = a strong wholesale lead.
# High roof_renovate score = roofing/solar lead. High refi score = mortgage lead.

# TraceAI — describe what you want in plain English, get a filter set back.
# Skip writing filter JSON by hand. Pipe the result into Bulk Property Data.

# 1. Send your description in natural language:
curl https://tracerfy.com/v1/api/lead-builder/ai-assist/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "absentee owners in Phoenix AZ with 50%+ equity,
              single-family, built before 1990"
  }'

# 2. Response — a structured spec ready to drop into /execute/:
{
  "strategy":       "absentee_owner",
  "strategy_label": "Absentee Owner",
  "geography": {
    "mode":   "city",
    "cities": ["Phoenix, AZ"]
  },
  "filter_overrides": {
    "property_type":       "SFR",
    "equity_percent_min":  50,
    "year_built_max":      1990
  },
  "rationale": {
    "summary": "Targeting absentee-owner single-family homes in Phoenix
      with 50%+ equity, built before 1990 (motivated long-term holders).",
    "steps":       ["Picked absentee_owner strategy", "Added equity + year-built filters"],
    "assumptions": ["Phoenix means the city in Arizona, not a neighborhood"],
    "warnings":    []
  },
  "confidence":          0.92,
  "needs_clarification": false,
  "conversation_id":     "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
  "credits_deducted":    1
}

# Tip: drop strategy + geography + filter_overrides straight into
# POST /v1/api/lead-builder/execute/ to run the list.
# Total cost: 1 credit (TraceAI) + 5 per delivered row (Bulk endpoint).

# Bulk Property Data — pick a strategy + geography, get an enriched list.

# 1. Send your spec (strategy preset + geography + optional overrides):
curl https://tracerfy.com/v1/api/lead-builder/execute/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "strategy": "absentee_owner",
    "geography": {
      "mode":   "city",
      "cities": ["Phoenix, AZ"]
    },
    "requested_count": 1000,
    "filter_overrides": {
      "equity_percent_min": 50,
      "year_built_max":     1990
    }
  }'

# 2. Immediate response (HTTP 202 — job queued):
{
  "id":              8841,
  "status":          "pending",
  "progress_stage":  "",
  "created_at":      "2026-06-27T02:14:38Z",
  "requested_count": 1000,
  "max_credit_cost": 5000,
  "poll_url":        "/v1/api/lead-builder/8841/"
}

# 3. Poll the poll_url, or wait for the webhook callback when done.
# Final CSV row shape includes 50+ property fields (every key from
# Property Snapshot — see that tab) plus the owner's phones, emails,
# DNC flags, and all 5 propensity scores. Misses cost zero — you only
# pay for actually delivered rows.

# DNC Lookup — check a single phone in real time against National, State,
# DMA, & litigator databases. Sub-second response. Perfect for live agent
# screens, click-to-call flows, and dialer warm-up checks.

# 1. Send the phone number:
curl https://tracerfy.com/v1/api/dnc/lookup/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "4805559876" }'

# 2. Response — sub-second:
{
  "phone":            "4805559876",
  "hit":              true,
  "is_clean":         false,
  "national_dnc":     true,
  "state_dnc":        true,
  "dma":              false,
  "litigator":        false,
  "phone_type":       "Mobile",
  "credits_deducted": 5
}

# Same call, a clean phone:
{
  "phone":            "4805551234",
  "hit":              true,
  "is_clean":         true,
  "national_dnc":     false,
  "state_dnc":        false,
  "dma":              false,
  "litigator":        false,
  "phone_type":       "Mobile",
  "credits_deducted": 5
}

# Tip: itemized flags (national/state/DMA/litigator) let you apply your
# own policy — e.g., block litigators always but allow state-DNC numbers
# if you have prior consent on file.
#
# Got 1,000+ phones to scrub at once? The batch endpoint
# /v1/api/dnc/scrub/ is 5x cheaper — 1 credit per phone vs 5.