# PropData Motivated Seller Lead API > Pre-scored motivated seller leads with phones, email, equity, foreclosure status, and market intelligence. Built on 165M+ government-sourced parcels + BatchData enrichment. Self-improving — the database gets denser with every API call. **Version:** 3.0.0 **Base URL:** `https://propdata-leads-api.sales-fd3.workers.dev` **Provider:** PropTechUSA.ai — Saint Paul, MN **Support:** propdata@proptechusa.ai --- ## Table of Contents 1. [Overview](#overview) 2. [Authentication](#authentication) 3. [Rate Limits and Quotas](#rate-limits-and-quotas) 4. [Endpoints](#endpoints) - [GET /v1/leads](#get-v1leads) - [GET /v1/leads/score](#get-v1leadsscore) - [GET /v1/leads/enrich](#get-v1leadsenrich) - [GET /v1/leads/market](#get-v1leadsmarket) - [GET /v1/leads/delta](#get-v1leadsdelta) - [GET /v1/leads/usage](#get-v1leadsusage) - [GET /v1/leads/health](#get-v1leadshealth) 5. [Response Reference](#response-reference) - [Lead Object](#lead-object) - [Motivation Score](#motivation-score) - [Contact Data](#contact-data) - [Equity Object](#equity-object) - [Market Intel](#market-intel) - [Risk Data](#risk-data) 6. [The Motivation Score](#the-motivation-score) 7. [Data Sources](#data-sources) 8. [Self-Improving Database](#self-improving-database) 9. [Tier Feature Matrix](#tier-feature-matrix) 10. [Error Codes](#error-codes) 11. [Code Examples](#code-examples) 12. [FAQ](#faq) --- ## Overview Most lead APIs give you a list of addresses. This one gives you a ranked, scored, phone-ready motivated seller pipeline. Every lead is scored 0–100 across 7 motivation signals and graded A through D. The API merges two data sources — 165M+ county assessor records and BatchData enriched properties — into a single response with equity position, loan data, foreclosure status, owner phones, email, and ZIP-level market intelligence. **Real example — actual API output:** ```json { "address": { "street": "1035 REDFERN AVE", "city": "DAYTON", "state": "OH", "zip": "45406" }, "owner": { "name": "Valesca Lafrance", "mailing_address": "146 10 Rockaway Blvd", "mailing_city": "Jamaica", "mailing_state": "NY", "mailing_zip": "11436" }, "motivation": { "score": 90, "grade": "A", "flags": [ "pre_foreclosure", "high_equity", "absentee_owner", "out_of_state_owner", "long_hold", "vacant" ], "years_held_estimated": 16.1 }, "equity": { "equity_dollars": 58637, "equity_pct": 100 }, "contact": { "phones": [ { "number": "9175699515", "type": "Mobile", "dnc": false, "source": "skip_trace" }, { "number": "9174031079", "type": "Mobile", "dnc": false, "source": "skip_trace" }, { "number": "7185297078", "type": "Landline", "dnc": false, "source": "skip_trace" } ] }, "market": { "gross_yield": 9.6, "zip_median_value": 86588, "hud_fmr_2br": 692.71 }, "batch_intel": { "batchrank": "High", "lead_status": "New" } } ``` Owner in Jamaica NY. Property in Dayton OH. Vacant. Free and clear. 16 years held. In foreclosure. Three callable numbers. That's a deal. --- ## Authentication **Via RapidAPI (recommended):** ``` X-RapidAPI-Key: YOUR_RAPIDAPI_KEY X-RapidAPI-Host: propdata-leads-api.sales-fd3.workers.dev ``` **Direct API key:** ``` x-api-key: YOUR_PROPDATA_KEY ``` --- ## Rate Limits and Quotas | Tier | Requests/Hour | Leads/Day | Skip Trace | AI Outreach | Delta | |------|--------------|-----------|------------|-------------|-------| | STARTER | 200 | 500 | — | — | — | | PRO | 500 | 2,500 | ✅ | ✅ | — | | ULTRA | 1,500 | Unlimited | ✅ | ✅ | ✅ | | MEGA | Unlimited | Unlimited | ✅ | ✅ | ✅ | **No per-lead fees. No per-call fees. Flat rate. Always.** Daily quota resets at midnight UTC. Check `/v1/leads/usage` for current consumption. --- ## Endpoints --- ### GET /v1/leads Search and rank motivated seller leads by ZIP or state. **URL** ``` GET https://propdata-leads-api.sales-fd3.workers.dev/v1/leads ``` **Query Parameters** | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `zip` | string | ✅ (or state) | 5-digit ZIP code | | `state` | string | ✅ (or zip) | 2-letter state code (e.g. `OH`) | | `min_score` | integer | ❌ | Minimum motivation score 0–100. Default: 0 | | `min_equity` | integer | ❌ | Minimum equity %. Default: 0 | | `absentee` | boolean | ❌ | `true` to filter absentee owners only | | `out_of_state` | boolean | ❌ | `true` to filter out-of-state owners only | | `preforeclosure` | boolean | ❌ | `true` to filter pre-foreclosure only | | `vacant` | boolean | ❌ | `true` to filter vacant properties only | | `property_type` | string | ❌ | Partial match (e.g. `Single Family`) | | `min_beds` | integer | ❌ | Minimum bedrooms | | `max_beds` | integer | ❌ | Maximum bedrooms | | `min_value` | integer | ❌ | Minimum market value in USD | | `max_value` | integer | ❌ | Maximum market value in USD | | `limit` | integer | ❌ | Results per call. Min: 1, Max: 100, Default: 25 | | `sort` | string | ❌ | `score` (default) \| `equity` \| `value` \| `held` \| `auction` | | `ai` | boolean | ❌ | `true` for AI outreach strategy on grade-A leads (PRO+) | **Request Example** ```http GET /v1/leads?state=OH&min_score=60&sort=score&limit=25 x-api-key: YOUR_KEY ``` **Response** ```json { "powered_by": "PropData Motivated Seller Lead API / PropTechUSA.ai", "query": { "state": "OH", "min_score": 60, "sort": "score", "limit": 25 }, "quota": { "used_today": 25, "limit_today": 2500, "resets_at": "2026-06-06T00:00:00.000Z", "tier": "pro" }, "summary": { "total_matched": 301, "returned": 25, "score_avg": 69, "score_max": 90, "grade_breakdown": { "A": 38, "B": 263, "C": 0, "D": 0 }, "flag_breakdown": { "pre_foreclosure": 233, "high_equity": 301, "absentee_owner": 301, "out_of_state_owner": 91, "long_hold": 301, "tax_delinquent": 0, "vacant": 31 } }, "leads": [ ... ], "generated_at": "2026-06-05T22:39:49.362Z" } ``` **Sort options:** | Value | Description | |-------|-------------| | `score` | Motivation score descending (default) | | `equity` | Equity percentage descending | | `value` | Estimated market value descending | | `held` | Years held descending (longest hold first) | | `auction` | Foreclosure auction date ascending (most urgent first) | --- ### GET /v1/leads/score Score any single property you already have. **URL** ``` GET https://propdata-leads-api.sales-fd3.workers.dev/v1/leads/score ``` **Query Parameters** | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `address` | string | ✅ (or parcel) | Street address | | `zip` | string | ✅ (with address) | 5-digit ZIP | | `parcel` | string | ✅ (or address) | FIPS-parcelID format (e.g. `39049-010-157084`) | | `ai` | boolean | ❌ | `true` for AI outreach strategy (PRO+) | **Request Examples** ```http GET /v1/leads/score?address=1035+Redfern+Ave&zip=45406 GET /v1/leads/score?parcel=39049-010-157084&ai=true ``` **Response** Returns a single [Lead Object](#lead-object). --- ### GET /v1/leads/enrich Enrich any US address with everything PropData knows. Pass an address, get back assessor data, BatchData contact info, live geocode, market data, and motivation score. Results persist permanently to the PropData learned database. **URL** ``` GET https://propdata-leads-api.sales-fd3.workers.dev/v1/leads/enrich ``` **Query Parameters** | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `address` | string | ✅ | Street address | | `zip` | string | ❌ | 5-digit ZIP (strongly recommended) | | `state` | string | ❌ | 2-letter state (fallback if no ZIP) | **Request Example** ```http GET /v1/leads/enrich?address=905+Sevall+St&zip=43701 ``` **Response** Returns a Lead Object with an additional `enrich_sources` block: ```json { "enrich_sources": { "assessor": false, "enriched_properties": true, "geocoder": true, "market_data": true }, "address": { "street": "905 SEVALL ST", "city": "ZANESVILLE", "zip": "43701", "state": "OH" }, "owner": { "name": "Samuel Osborn", "mailing_address": "540 Abbey Pl", "mailing_city": "Zanesville", "mailing_state": "OH" }, "motivation": { "score": 70, "grade": "B", "flags": ["pre_foreclosure", "high_equity", "absentee_owner", "long_hold"] }, "contact": { "phones": [{ "number": "7402970972", "type": "Mobile", "dnc": false }], "email": "hosborn82@gmail.com", "email_2": "herb513@hotmail.com" }, "_geocoded": true } ``` --- ### GET /v1/leads/market ZIP-level market intelligence for investment context. **URL** ``` GET https://propdata-leads-api.sales-fd3.workers.dev/v1/leads/market ``` **Query Parameters** | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `zip` | string | ✅ | 5-digit ZIP code | **Response** ```json { "zip": "45406", "state": "OH", "market": { "median_home_value": 86588.79, "hud_fmr_2br": 692.71, "gross_yield": 9.6, "yoy_appreciation": 1.28, "vacancy_pct": 21.86, "unemployment": 12.97, "irs_pct_over_200k": 4.9, "nfip_claims": null }, "income": { "median_household_income": 28450, "poverty_rate": 31.2, "housing_cost_burden_pct": 42.1 }, "demographics": { "population": 18420, "median_age": 34.1, "owner_occupied_pct": 38.2, "vacancy_rate": 21.86, "median_rent": 692 }, "housing_stock": { "total_parcels": 2034, "median_value": 74000, "avg_year_built": 1941, "absentee_count": 847, "vacant_count": 312 }, "flood_risk": { "nfip_claim_count": null, "nfip_total_paid": null }, "lead_signals": { "active_preforeclosures": 47, "preforeclosure_density": 2.31 } } ``` --- ### GET /v1/leads/delta Pull all property records updated since a given timestamp. Built for nightly or weekly pipeline sync. Paginated with cursor. **ULTRA tier and above only.** **URL** ``` GET https://propdata-leads-api.sales-fd3.workers.dev/v1/leads/delta ``` **Query Parameters** | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `since` | string | ✅ | ISO 8601 timestamp (e.g. `2026-06-01T00:00:00Z`) | | `zip` | string | ✅ (or state) | Filter to ZIP | | `state` | string | ✅ (or zip) | Filter to state | | `cursor` | string | ❌ | Pagination cursor from previous `next_cursor` | | `limit` | integer | ❌ | Records per page. Max 1000, default 100 | **Response** ```json { "count": 100, "has_more": true, "next_cursor": "2026-06-03T10:19:57.433138+00:00", "leads": [ { "parcel_id": "39049-010-157084", "_delta": { "fetched_at": "2026-06-03T10:19:57.433138+00:00", "changed_since": "2026-06-01T00:00:00Z" } } ] } ``` **Pagination pattern:** ```javascript let cursor = null; let hasMore = true; while (hasMore) { const url = `/v1/leads/delta?since=2026-06-01T00:00:00Z&state=OH&limit=100${cursor ? `&cursor=${cursor}` : ''}`; const result = await fetch(url, { headers }); const data = await result.json(); processLeads(data.leads); hasMore = data.has_more; cursor = data.next_cursor; } ``` --- ### GET /v1/leads/usage Check daily lead quota, tier features, and reset time. **URL** ``` GET https://propdata-leads-api.sales-fd3.workers.dev/v1/leads/usage ``` **Response** ```json { "tier": "pro", "leads_used_today": 142, "leads_limit_today": 2500, "resets_at": "2026-06-06T00:00:00.000Z", "features": { "skip_trace": true, "ai_narratives": true, "delta_endpoint": false, "enrich_endpoint": true } } ``` --- ### GET /v1/leads/health API status, scoring weights, and data source list. No authentication required. **URL** ``` GET https://propdata-leads-api.sales-fd3.workers.dev/v1/leads/health ``` --- ## Response Reference --- ### Lead Object | Field | Type | Nullable | Description | |-------|------|----------|-------------| | `parcel_id` | string | ✅ | County FIPS + parcel ID. Null for enriched-only leads. | | `county_fips` | string | ✅ | 5-digit county FIPS code | | `county_name` | string | ✅ | County name | | `_source` | string | ❌ | `assessor` or `enriched_properties` | | `address` | object | ❌ | Street, city, ZIP, state | | `owner` | object | ❌ | Name, mailing address | | `valuation` | object | ❌ | Market value, assessed value, last sale, ARV | | `equity` | object | ❌ | Equity dollars, equity %, loan data, LTV | | `characteristics` | object | ❌ | Type, sqft, beds, baths, year built | | `motivation` | object | ❌ | Score, grade, flags, years held | | `flags` | object | ❌ | Boolean signal flags | | `foreclosure` | object | ✅ | Foreclosure details. Null if not in foreclosure. | | `mls` | object | ✅ | MLS status. Null if not listed. | | `contact` | object | ❌ | Phones, email | | `batch_intel` | object | ✅ | BatchRank, lead score, lead status | | `market` | object | ✅ | ZIP-level market data | | `risk` | object | ❌ | NRI hazard scores, crime rates | | `ai_outreach` | string | ✅ | AI strategy (PRO+, ?ai=true). `null` if not requested. | | `data_as_of` | string | ✅ | When the record was last fetched | | `_geocoded` | boolean | ❌ | `true` if Census geocoder was used to fill address gaps | --- ### Motivation Score | Field | Type | Description | |-------|------|-------------| | `score` | integer | 0–100 | | `grade` | string | A (75–100), B (60–74), C (40–59), D (0–39) | | `flags` | array | Which signals fired | | `years_held_estimated` | float | Estimated years owner has held the property | | `score_breakdown` | object | Points available per signal | **Possible flags:** | Flag | Points | Condition | |------|--------|-----------| | `pre_foreclosure` | 25 | Active NOD/NTS filing in leads table OR foreclosure_status in BatchData | | `high_equity` | 20 | Equity ≥ 40% of estimated value | | `equity_estimated` | 10 | Equity estimated (no sale data) — partial points | | `absentee_owner` | 15 | owner_occupied = false OR mailing ZIP ≠ property ZIP | | `out_of_state_owner` | 15 | Mailing state ≠ property state | | `long_hold` | 10 | Last sale date ≥ 10 years ago | | `tax_delinquent` | 10 | tax_status = "delinquent" or "tax_lien" | | `vacant` | 5 | is_vacant = true OR no improvement value | --- ### Contact Data | Field | Type | Tier | Description | |-------|------|------|-------------| | `phones` | array | Starter (assessor only) / PRO (full) | Phone numbers with type and DNC flag | | `email` | string | PRO+ | Primary owner email | | `email_2` | string | PRO+ | Secondary owner email | **Phone object:** | Field | Type | Description | |-------|------|-------------| | `number` | string | 10-digit phone number | | `type` | string | `Mobile`, `Landline`, `VoIP`, or `unknown` | | `dnc` | boolean | **`true` = Do Not Call list. Never dial DNC numbers.** | | `source` | string | `assessor` (public record) or `skip_trace` (BatchData) | --- ### Equity Object | Field | Type | Description | |-------|------|-------------| | `equity_dollars` | integer | Pre-computed equity in USD | | `equity_pct` | integer | Equity as % of estimated value | | `loan_balance` | number | Estimated remaining loan balance | | `loan_type` | string | Loan type (conventional, FHA, etc.) | | `loan_lender` | string | Lender name | | `loan_rate` | number | Interest rate | | `ltv_pct` | integer | Loan-to-value ratio % | --- ### Market Intel | Field | Type | Description | |-------|------|-------------| | `zip_median_value` | number | ZIP median home value (ZHVI) | | `hud_fmr_2br` | number | HUD Fair Market Rent 2BR in USD/month | | `gross_yield` | number | Estimated gross rental yield % | | `yoy_appreciation` | number | Year-over-year appreciation % | | `vacancy_pct` | number | Vacancy rate % | | `unemployment` | number | Unemployment rate % | | `irs_pct_over_200k` | number | % of tax returns over $200k (wealth signal) | | `nfip_claims` | integer | NFIP flood insurance claim count | **Interpreting gross yield:** | Yield | Signal | |-------|--------| | > 9% | Strong cash flow market | | 6–9% | Moderate cash flow | | < 6% | Appreciation play, thin cash flow | --- ### Risk Data Populated where NRI enrichment has run on the assessor record. Null for enriched-only leads. | Field | Description | |-------|-------------| | `fema_flood_zone` | FEMA flood zone designation (Zone A, AE, X, etc.) | | `nri_risk_score` | FEMA NRI composite risk score | | `nri_wildfire` | Wildfire risk score | | `nri_flood` | Flood risk score | | `nri_hurricane` | Hurricane risk score | | `nri_tornado` | Tornado risk score | | `nri_earthquake` | Earthquake risk score | | `crime_total` | Total crime rate per 100k | | `crime_violent` | Violent crime rate per 100k | | `sovi_score` | Social Vulnerability Index score | | `is_food_desert` | USDA food desert designation | --- ## The Motivation Score The scoring engine evaluates every property against 7 signals weighted by acquisition relevance. Signals are independent — a property can score on all 7 simultaneously (max 100). ``` Score 90 — Valesca Lafrance, Dayton OH ────────────────────────────────────── pre_foreclosure 25pts ← Active Notice of Sale high_equity 20pts ← $58k equity, 100% LTV-free absentee_owner 15pts ← Mailing in Jamaica NY out_of_state_owner 15pts ← NY owner, OH property long_hold 10pts ← Held 16.1 years vacant 5pts ← Property vacant ────────────────────────────────────── Total: 90pts Grade: A ``` **Grade interpretation:** | Grade | Score | Action | |-------|-------|--------| | A | 75–100 | Call today. Multiple high-conviction signals. | | B | 60–74 | Strong lead. Work within the week. | | C | 40–59 | Warm. Add to drip campaign. | | D | 0–39 | Low signal. Skip or back-burner. | **AI Outreach (PRO+, ?ai=true):** Grade-A leads get a Claude-generated 2-sentence outreach strategy: ``` CALL — This owner has been carrying a vacant property in Dayton from New York for 16 years and is now in active foreclosure with 100% equity. Reach out immediately before the auction date. ``` Starts with `BUY —`, `CALL —`, `MAIL —`, or `SKIP —`. --- ## Data Sources | Source | Data | Coverage | |--------|------|----------| | `county_assessor` | Parcel records, assessed value, last sale, property type, NRI scores, crime rates | 165M+ parcels, 50 states | | `enriched_properties` | Owner phones (up to 5), email, equity, loan data, ARV, foreclosure status, MLS status | BatchData enrichment, OH primary | | `leads` | Active pre-foreclosure filings (NOD/NTS) | Scraped filings, updated regularly | | `avm_zip_cache` | ZHVI, HUD FMR, gross yield, IRS income distribution, NFIP flood claims | All US ZIPs | | `census_acs_zip` | Demographics, income, vacancy, poverty, cost burden | All US ZIPs | | `census_geocoder` | Live address resolution | US government, no ToS concerns | --- ## Self-Improving Database The API gets smarter with every call. **How it works:** 1. Every `/v1/leads/enrich` call geocodes the address via the US Census geocoder 2. The geocoded result (city, state, county, FIPS, lat/lon) is persisted to the `learned_leads` table 3. Future calls to that address return instantly from the learned cache — no geocoder hit 4. Missing `city`/`state` on `/v1/leads` results are geocoded live and persisted async — the next caller gets a populated result **The principle:** Every address you enrich today becomes PropData's data permanently. You're not just consuming the API — you're building it. --- ## Tier Feature Matrix | Feature | STARTER | PRO | ULTRA | MEGA | |---------|---------|-----|-------|------| | `/v1/leads` | ✅ | ✅ | ✅ | ✅ | | `/v1/leads/score` | ✅ | ✅ | ✅ | ✅ | | `/v1/leads/enrich` | ✅ | ✅ | ✅ | ✅ | | `/v1/leads/market` | ✅ | ✅ | ✅ | ✅ | | `/v1/leads/delta` | — | — | ✅ | ✅ | | Skip trace phones + email | — | ✅ | ✅ | ✅ | | AI outreach strategy | — | ✅ | ✅ | ✅ | | Daily leads | 500 | 2,500 | Unlimited | Unlimited | | Requests/hour | 200 | 500 | 1,500 | Unlimited | --- ## Error Codes | Status | Description | |--------|-------------| | 200 | Success | | 400 | Bad request — missing or invalid parameters. Check `error` field. | | 401 | Invalid or missing API key | | 403 | Feature requires higher tier | | 404 | Property not found | | 429 | Rate limit or daily quota exceeded | **Error response shape:** ```json { "error": "Provide ?zip=XXXXX or ?state=XX", "status": 400, "generated_at": "2026-06-05T22:00:00.000Z" } ``` **Rate limit response:** ```json { "error": "Daily quota of 500 exceeded. Resets midnight UTC.", "status": 429 } ``` --- ## Code Examples ### JavaScript / Fetch ```javascript const BASE_URL = 'https://propdata-leads-api.sales-fd3.workers.dev'; const API_KEY = 'YOUR_RAPIDAPI_KEY'; const HEADERS = { 'X-RapidAPI-Key': API_KEY, 'X-RapidAPI-Host': 'propdata-leads-api.sales-fd3.workers.dev' }; // Get grade-A leads for Ohio async function getTopLeads(state = 'OH', minScore = 75) { const params = new URLSearchParams({ state, min_score: minScore, sort: 'score', limit: '25' }); const res = await fetch(`${BASE_URL}/v1/leads?${params}`, { headers: HEADERS }); const data = await res.json(); console.log(`Total matched: ${data.summary.total_matched}`); console.log(`Grade A: ${data.summary.grade_breakdown.A}`); data.leads.forEach(lead => { console.log(`\n${lead.motivation.grade} — Score: ${lead.motivation.score}`); console.log(` ${lead.address.street}, ${lead.address.city} ${lead.address.state}`); console.log(` Owner: ${lead.owner.name} (mailing: ${lead.owner.mailing_state})`); console.log(` Equity: $${lead.equity.equity_dollars?.toLocaleString()} (${lead.equity.equity_pct}%)`); console.log(` Flags: ${lead.motivation.flags.join(', ')}`); console.log(` Phones: ${lead.contact.phones.length} (${lead.contact.phones.filter(p => !p.dnc).length} callable)`); }); return data.leads; } // Enrich a specific address async function enrichAddress(address, zip) { const params = new URLSearchParams({ address, zip }); const res = await fetch(`${BASE_URL}/v1/leads/enrich?${params}`, { headers: HEADERS }); return res.json(); } // Score and get AI outreach for a single property async function scoreWithAI(address, zip) { const params = new URLSearchParams({ address, zip, ai: 'true' }); const res = await fetch(`${BASE_URL}/v1/leads/score?${params}`, { headers: HEADERS }); const lead = await res.json(); console.log(`Score: ${lead.motivation.score} (${lead.motivation.grade})`); console.log(`AI: ${lead.ai_outreach}`); return lead; } ``` --- ### Python ```python import requests BASE_URL = "https://propdata-leads-api.sales-fd3.workers.dev" HEADERS = { "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY", "X-RapidAPI-Host": "propdata-leads-api.sales-fd3.workers.dev" } def get_leads(state=None, zip_code=None, min_score=60, sort="score", limit=25): params = {"sort": sort, "limit": limit, "min_score": min_score} if state: params["state"] = state if zip_code: params["zip"] = zip_code resp = requests.get(f"{BASE_URL}/v1/leads", params=params, headers=HEADERS) resp.raise_for_status() data = resp.json() print(f"Total matched: {data['summary']['total_matched']}") print(f"Grade A: {data['summary']['grade_breakdown']['A']}") print(f"Pre-foreclosure: {data['summary']['flag_breakdown']['pre_foreclosure']}") return data["leads"] def enrich_address(address, zip_code=None): params = {"address": address} if zip_code: params["zip"] = zip_code resp = requests.get(f"{BASE_URL}/v1/leads/enrich", params=params, headers=HEADERS) resp.raise_for_status() return resp.json() def get_callable_phones(lead): """Return phones that are not on DNC list.""" return [p for p in lead.get("contact", {}).get("phones", []) if not p.get("dnc")] # Example: pull Ohio leads and print callable numbers leads = get_leads(state="OH", min_score=75) for lead in leads[:5]: phones = get_callable_phones(lead) print(f"\n{lead['owner']['name']} — Score: {lead['motivation']['score']}") print(f" {lead['address']['street']}, {lead['address']['city']}") print(f" Equity: ${lead['equity']['equity_dollars']:,} ({lead['equity']['equity_pct']}%)") print(f" Callable phones: {[p['number'] for p in phones]}") print(f" Flags: {', '.join(lead['motivation']['flags'])}") ``` --- ### Node.js / Axios ```javascript const axios = require('axios'); const client = axios.create({ baseURL: 'https://propdata-leads-api.sales-fd3.workers.dev', headers: { 'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY', 'X-RapidAPI-Host': 'propdata-leads-api.sales-fd3.workers.dev' } }); // Nightly sync using delta endpoint (ULTRA tier) async function nightlySync(state, since) { let cursor = null; let hasMore = true; let total = 0; while (hasMore) { const params = { since, state, limit: 100, ...(cursor ? { cursor } : {}) }; const { data } = await client.get('/v1/leads/delta', { params }); // Process this page for (const lead of data.leads) { await processLead(lead); } total += data.leads.length; hasMore = data.has_more; cursor = data.next_cursor; console.log(`Synced ${total} records...`); } console.log(`Sync complete. Total: ${total}`); } // Filter leads for wholesaler outreach list async function buildOutreachList(state) { const { data } = await client.get('/v1/leads', { params: { state, min_score: 60, absentee: 'true', preforeclosure: 'true', sort: 'auction', // most urgent auctions first limit: 100 } }); return data.leads .filter(l => !l.flags.is_listed_on_mls) // skip listed properties .filter(l => l.contact.phones.some(p => !p.dnc)) // must have callable number .map(l => ({ name: l.owner.name, address: l.address.street, city: l.address.city, state: l.address.state, score: l.motivation.score, equity: l.equity.equity_dollars, phones: l.contact.phones.filter(p => !p.dnc).map(p => p.number), auction: l.foreclosure?.auction_date, days: l.foreclosure?.days_to_auction, })); } ``` --- ### React — Lead Dashboard ```jsx import { useState, useEffect } from 'react'; const API_KEY = 'YOUR_RAPIDAPI_KEY'; const BASE_URL = 'https://propdata-leads-api.sales-fd3.workers.dev'; function LeadDashboard({ state = 'OH' }) { const [leads, setLeads] = useState([]); const [summary, setSummary] = useState(null); const [loading, setLoading] = useState(true); const [minScore,setMinScore]= useState(60); useEffect(() => { fetchLeads(); }, [state, minScore]); async function fetchLeads() { setLoading(true); const params = new URLSearchParams({ state, min_score: minScore, sort: 'score', limit: '25' }); const res = await fetch(`${BASE_URL}/v1/leads?${params}`, { headers: { 'X-RapidAPI-Key': API_KEY, 'X-RapidAPI-Host': 'propdata-leads-api.sales-fd3.workers.dev' } }); const data = await res.json(); setLeads(data.leads || []); setSummary(data.summary); setLoading(false); } const gradeColor = { A: '#16a34a', B: '#2563eb', C: '#d97706', D: '#9ca3af' }; return (

{summary && Object.entries(summary.grade_breakdown).map(([grade, count]) => (

{count}

Grade {grade}

))}

{loading ?

: leads.map((lead, i) => (

{lead.owner?.name || 'Unknown Owner'}

{lead.address.street}, {lead.address.city} {lead.address.state}

{lead.motivation.flags.map(f => ( {f.replace(/_/g, ' ')} ))}

{lead.motivation.score}

Grade {lead.motivation.grade}

{lead.equity.equity_dollars && ( 💰 ${lead.equity.equity_dollars.toLocaleString()} equity ({lead.equity.equity_pct}%) )} {lead.contact.phones.length > 0 && ( 📞 {lead.contact.phones.filter(p => !p.dnc).length} callable )} {lead.foreclosure && ( ⚠️ {lead.foreclosure.status} )}

))}

); } export default LeadDashboard; ``` --- ## FAQ **Q: Why do some leads have `parcel_id: null`?** These leads come from the `enriched_properties` (BatchData) table and haven't been matched to a county assessor record yet. They still have full contact data, equity, and motivation score — just no parcel ID. As assessor ingest expands, more will get matched. **Q: What does `_source: "enriched_properties"` mean?** The lead was found in the BatchData enrichment database but not yet in the county assessor database. These leads often have richer contact data (phones, email, equity) than assessor-only leads. **Q: What is `_geocoded: true`?** The address was missing city or state, so the API called the US Census geocoder to fill the gap. The result was also persisted to the PropData learned database — future calls for that address are instant. **Q: Why does `days_to_auction` return null for some foreclosures?** The auction date has already passed. The foreclosure flag still fires (25pts) because the property is still in our pre-foreclosure database — it may have been postponed or rescheduled. Worth investigating directly. **Q: I called ?preforeclosure=true but some leads don't have a foreclosure object.** Pre-foreclosure can be triggered by the `leads` table (active NOD/NTS filings by ZIP) even if BatchData doesn't have a specific `foreclosure_status` record. In that case the flag fires but the `foreclosure` object is null. Add `?state=OH&preforeclosure=true` and check `flags.is_preforeclosure` rather than the foreclosure object. **Q: Are DNC-flagged phones safe to call?** No. `dnc: true` means the number is on the National Do Not Call Registry. Never call DNC-flagged numbers. Filter them out before building your outreach list. The API flags them for compliance — it does not strip them so you can make your own compliance decisions. **Q: What states are available?** Ohio is fully enriched right now (984 BatchData records, 984 with phones and equity). All 50 states have assessor data at varying coverage levels. `/v1/leads/health` shows current data sources. Coverage expands continuously as ingest and BatchData enrichment runs. **Q: Can I use this for the /v1/leads/enrich endpoint to build my own list?** Yes. Pass any address and the API returns everything it knows plus live geocode. Results persist to the PropData database — you're contributing to the dataset with every call. Your enriched addresses are available to future API users (anonymized — no PII is shared beyond what's already in public assessor records). **Q: Do you have skip trace for states other than Ohio?** The `enriched_properties` table currently has 984 Ohio records plus a small number in FL, AL, MI, NC, TX. Skip trace availability is shown via `has_phone` flag on each lead. Where BatchData hasn't run, phones come from the assessor `phone` field (public record). **Q: Is this compliant with fair lending laws?** The motivation score is based on property and ownership signals — not demographic characteristics. It is your responsibility to use this data in compliance with the Fair Housing Act, Equal Credit Opportunity Act, TCPA (honor DNC flags), CAN-SPAM, and all applicable federal and state law. See Terms of Service for full details. **Q: Do you have a full property records API?** Yes. PropData — Real Estate Market Intelligence API includes full property lookup by address/ZIP/parcel, market intelligence, rent estimates, comps, geocoding, preforeclosure leads, skip trace, and state-level investment signals. 166M+ parcels, 16 live data sources, $49/mo flat. → Available on RapidAPI --- *PropData Motivated Seller Lead API — v3.0.0* *Built by PropTechUSA.ai — Saint Paul, MN* *propdata@proptechusa.ai | https://propdata.proptechusa.ai*