PreCloseFeed
v1.0 Client Portal

PreCloseFeed API Documentation

Programmatic access to high-equity pre-foreclosure and tax deed lead data across 8 Florida counties. Authenticate with a Bearer token (API key) and receive clean, structured lead data in JSON format.

Base URL: https://preclosefeed.com/api/v1

Authentication

All API requests require a valid API key passed as a Bearer token in the Authorization header.

Authorization: Bearer dp_abc123def456...

Requests without a valid API key will receive a 401 Unauthorized response.

Getting your API key: Purchase API Access from the pricing page, then log into your portal to view your key.

Pricing

API Access — All 8 Florida Counties
$97 /month

✓ Unlimited API requests (300 req/min)

✓ Full access to all 8 Florida counties

✓ Pre-foreclosure + tax deed + absentee owner data

✓ Paginated results with offset/limit

✓ Filter by county, equity, days to auction, property type, and more

✓ Cancel anytime

Subscribe — $97/mo

Your API key will be generated automatically after purchase and available in your portal.

Rate Limits

300 requests per minute per API key.

If you exceed the rate limit, you will receive a 429 Too Many Requests response. Rate limits reset every 60 seconds.

For higher limits, contact admin@preclosefeed.com.

Error Responses

401{"error": "Invalid API key"}

404{"error": "County not found"}

403{"error": "Subscription expired..."}

429 — Rate limit exceeded

500 — Internal server error

POST /api/v1/leads

Fetch pre-foreclosure and tax deed leads with advanced filtering. Filters are sent as a JSON body.

Request Body

{
  "county": "orange",               // required: county name
  "filters": {                      // optional: all fields below optional
    "days": 21,                     // max days_to_auction
    "propertyType": "residential",  // filter by property_use
    "minValue": 50000,              // min assessed value ($)
    "maxValue": 500000,             // max assessed value ($)
    "source": "foreclosure",        // auction type filter
    "limit": 100,                   // results per page (1-1000, default 100)
    "offset": 0                     // pagination offset (default 0)
  }
}

Response

{
  "leads": [
    {
      "county": "orange",
      "case_number": "2024-CA-001234",
      "parcel_id": "23-45-67-8901",
      "owner_name": "JOHN MICHAEL DOE JR",
      "property_address_full": "123 MAIN ST, ORLANDO, FL 32801",
      "property_address_street": "123 MAIN ST",
      "property_address_city": "ORLANDO",
      "assessed_value_num": "250000",
      "final_judgment_amount_num": "180000",
      "auction_date": "2025-08-15",
      "auction_type": "FORECLOSURE",
      "auction_status": "SCHEDULED",
      "property_use": "RESIDENTIAL",
      "non_owner_occupied": "true",
      "owner_mailing_address": "123 MAIN ST, ORLANDO, FL 32801",
      "last_sale_date": null,
      "last_sale_price_num": null,
      "parcel_url": null,
      "hcpafl_site_address": "123 MAIN ST",
      "last_seen": "2025-07-01",
      "ls_full_name": null,
      "ls_dob": null,
      "ls_phones_json": null,
      "ls_emails_json": null,
      "ls_spouses_json": null,
      "ls_source_url": null
    }
  ],
  "total": 1
}

GET /api/v1/leads

Same as POST, but filters are sent as query parameters. Useful for simple integrations.

GET /api/v1/leads?county=hillsborough&days=30&minValue=50000&limit=50&offset=0
Authorization: Bearer dp_your_api_key_here

cURL Examples

Basic request — all leads for a county

curl -X POST https://preclosefeed.com/api/v1/leads \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"county": "hillsborough"}'

With filters

curl -X POST https://preclosefeed.com/api/v1/leads \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"county":"hillsborough","filters":{"days":30,"minValue":100000,"maxValue":500000,"propertyType":"residential"}}'

GET example with query parameters

curl "https://preclosefeed.com/api/v1/leads?county=orange&limit=5&offset=0" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

Python Examples

import requests

API_KEY = "sk_live_your_api_key_here"
BASE_URL = "https://preclosefeed.com/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# Fetch leads for a county with filters
payload = {
    "county": "hillsborough",
    "filters": {
        "days": 30,
        "minValue": 50000,
        "propertyType": "residential",
        "limit": 100,
        "offset": 0,
    },
}

response = requests.post(f"{BASE_URL}/leads", headers=headers, json=payload)
data = response.json()

print(f"Found {data['total']} leads")
for lead in data["leads"]:
    print(f"{lead['owner_name']} | {lead['property_address_full']} | Equity: ${lead.get('assessed_value_num',0)}")

Node.js Examples

const API_KEY = "sk_live_your_api_key_here";
const BASE_URL = "https://preclosefeed.com/api/v1";

async function fetchLeads(county, filters = {}) {
  const response = await fetch(`${BASE_URL}/leads`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      county,
      filters: {
        days: 30,
        minValue: 100000,
        propertyType: "residential",
        limit: 50,
        offset: 0,
        ...filters,
      },
    }),
  });

  const data = await response.json();
  console.log(`Found ${data.total} leads`);
  return data.leads;
}

// Usage
fetchLeads("palm_beach", { days: 14 }).then(leads => {
  leads.forEach(l => console.log(l.owner_name, l.parcel_id));
});

FAQ

How do I get an API key?

Purchase API Access ($97/month) from the pricing page. After checkout, log into your portal at preclosefeed.com/login to view your API key.

Can I regenerate my API key?

Yes. Log into your portal and click "Regenerate Key" under the API Access section. The old key will be immediately invalidated.

What counties are available?

Hillsborough, Pinellas, Pasco, Polk, Orange, Duval, Palm Beach, and Miami-Dade. All counties are included with API Access.

What property types are included?

Pre-foreclosure (Lis Pendens), tax deed auctions, and absentee owner records. Filter by source to narrow by auction type.

How fresh is the data?

Data is synced nightly at 2:00 AM PST directly from Florida county courthouse databases.