ScraperCity logo

Deal Finder API Documentation

Deal Finder

Find distressed, motivated-seller properties in any US market - pre-foreclosures, foreclosures, auctions, and bank-owned (REO). Returns full address, distress type, value estimates, and property details. Pair with People Finder to reach the owner.

$0.05 per propertyPOST /api/v1/scrape/distress-list

Parameters

NameTypeRequiredDescription
searchstringRequiredTarget market: city + state, or ZIP codeExample: Tampa, FL
distressTypesstring[]OptionalSignals to include: preForeclosure, foreclosure, auction, bankOwnedDefault: ["preForeclosure"]Example: ["preForeclosure", "auction"]
maxItemsnumberOptionalMax properties to return (1-500)Default: 100Example: 250

Examples

Pull pre-foreclosures in a market

curl -X POST https://app.scrapercity.com/api/v1/scrape/distress-list \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search": "Tampa, FL",
    "distressTypes": ["preForeclosure"],
    "maxItems": 100
  }'

Use Cases

  • Sourcing off-market deals before they hit the MLS
  • Building motivated-seller lists for wholesalers and investors
  • Tracking foreclosure and auction inventory by market
  • Feeding distressed leads into skip-trace and outreach workflows

Best Practices

  • Use a city + state or a ZIP for the tightest results
  • Start with preForeclosure - the highest-intent seller signal
  • You only pay for properties actually returned
  • Pair with People Finder to get the owner phone and email
  • Pull one market per request; run several to cover a whole county

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.