# Auction Property Leads - Sheriff Sales, Trustee Sales, Online (`seibs.co/property-auction-leads`) Actor

Bulk Zillow auction property listings: sheriff sales, trustee sales, online foreclosure auctions. Filter by city/state, price, beds/baths/sqft. Auto-computes flip score, ARV estimate, rehab cost, MAO (70% rule). Built for cash buyers, wholesalers, flippers hunting auction inventory.

- **URL**: https://apify.com/seibs.co/property-auction-leads.md
- **Developed by:** [Seibs.co](https://apify.com/seibs.co) (community)
- **Categories:** Real estate, Lead generation, Business
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Auction Property Leads - Sheriff, Trustee, Online Auctions

Bulk Zillow auction-status property scraper for cash buyers, wholesalers, and flippers hunting auction inventory with first-pass underwriting attached.

### What does Auction Property Leads do?

Pulls every auction-status listing surfaced through Zillow - sheriff sales, trustee sales, and online foreclosure auctions (Auction.com, Hubzu, ServiceLink, Xome) - for the cities you supply, optionally enriches each detail page (description, full price history, nearby comps, schools, HOA, contact info), and computes a transparent flip score plus 70%-rule deal metrics. Defaults to `only_auctions=true` so you do not have to remember to toggle it.

### Features

- Three auction flavors normalized: sheriff sale (county-conducted, courthouse steps, 24-48 hour cash), trustee sale (lender-conducted, deed-of-trust states), online auction (Auction.com / Hubzu / ServiceLink / Xome).
- Pre-set `only_auctions=true` default - no manual toggle needed.
- Detail-page enrichment: description, photo count, price history, up to 15 ACTIVE comps, up to 15 SOLD comps (critical because auction buyers cannot inspect interior), schools, HOA, property tax rate, contact info.
- Flip score (0.0 - 1.0) with reasons array and per-signal breakdown: condition keywords, DOM, price-vs-Zestimate, price drops, age, status, photos.
- Deal metrics: ARV (comp + Zestimate blend), rehab cost (older homes get larger assumptions), MAO 70% / 75% / 65%, profit estimate, holding cost, rent-to-price ratio.
- Auction-aware rehab pricing: +$20/sqft sight-unseen premium baked in.
- Owner intel: skip-trace-ready record, absentee inference, estimated equity %, years owned.
- Distress sub-categorization, climate risk, walk/transit/bike scores.

### Use cases

- Cash buyers hunting auction inventory in target metros
- Wholesalers building distressed-property pipelines
- Fix-and-flip operators looking for off-market and lender-conducted sales
- Real-estate funds and family offices monitoring auction supply across markets
- Investor lead-list resellers who want a recurring auction feed
- Hard money / private lenders prospecting active auction bidders

### FAQ

**Q: Is this legal?**
A: Yes. Auction listings on Zillow are publicly accessible. The actor never logs in, never bypasses a paywall, and never scrapes private data. You are responsible for following Zillow's terms of service and any local rules on contacting trustees, owners, or auction bidders.

**Q: Sheriff sale vs trustee sale - what's the difference and when does each matter?**
A: A `sheriff_sale` is a judicial foreclosure conducted by the county sheriff on the courthouse steps after a judge orders the sale - common in IL, NJ, NY, FL, PA, OH and most "judicial" states. A `trustee_sale` is a non-judicial foreclosure conducted by a trustee under a deed-of-trust power-of-sale clause, no court involvement - common in CA, TX, AZ, NV, GA, WA and most "non-judicial" states. Pattern matters because (1) trustee sales move 2-3x faster than sheriff sales, so your lead-time window is shorter, (2) sheriff-sale states usually have a redemption period giving the owner months to reclaim the property post-sale, (3) trustee-sale states often allow online bidding (Auction.com, Hubzu) while sheriff sales are physical courthouse-step events.

**Q: Why might a run fail?**
A: The three most common failure modes are (1) Zillow blocking your IP because you skipped the residential proxy default, (2) a location string that Zillow's geocoder cannot resolve, and (3) hitting Zillow's hard 500-result cap per search URL - split large metros into ZIP-cluster runs.

**Q: How fresh is the data?**
A: Live at run time. Auction date, opening bid, and trustee details are pulled from Zillow's auction detail page when present. Note: Zillow updates auction-day fields inconsistently. Treat the actor as a discovery layer, then verify sale-day details against the trustee / sheriff / Auction.com / Hubzu source of truth before bidding.

**Q: Can I schedule this daily or weekly?**
A: Yes. Daily cron is appropriate for high-velocity auction markets (Phoenix, Atlanta, Tampa, Las Vegas). Weekly works for slower geos. Apify Schedules + `zpid` dedupe = a clean delta feed into your CRM.

**Q: Does it integrate with my CRM or data tooling?**
A: Yes. Apify webhooks POST every successful run to HubSpot, Salesforce, Pipedrive, Apollo, or any HTTP endpoint. Zapier, Make.com, and n8n templates available. Dataset exports as JSON / CSV / Excel / XML.

**Q: How does pricing work?**
A: PAY_PER_EVENT. You pay per listing record, with a small enrichment fee per detail page and a surcharge on records that clear the auction-quality bar. You only pay for what the actor actually emits.

**Q: Can I dedupe across runs?**
A: Yes. Dedupe on `zpid` - it's Zillow's stable parcel identifier and persists across runs and status changes.

### Related Actors

- [foreclosure-property-leads](https://apify.com/) - upstream sibling for pre-foreclosure, REO, and bank-owned inventory.
- [house-flipper-leads](https://apify.com/) - same engine targeting the full active distressed-flip inventory.
- [court-records-intel](https://apify.com/) - pull the underlying foreclosure judgment, order of sale, and case docket that drove a trustee or sheriff to the courthouse steps.

### Integrations

- Zapier - push to HubSpot/Salesforce/Pipedrive/Apollo
- Make.com - workflow automation
- n8n - self-hosted automation
- Apify webhooks - POST to your endpoint
- API + dataset export (JSON/CSV/Excel/XML)
- MCP / AI agents - call from Claude/GPT/LangChain

### Input

```json
{
    "locations": ["Atlanta, GA", "Houston, TX"],
    "only_auctions": true,
    "include_foreclosures": true,
    "min_price": 50000,
    "max_price": 350000,
    "min_beds": 2,
    "min_sqft": 800,
    "home_types": ["SingleFamily"],
    "days_on_zillow_min": 14,
    "min_flip_score": 0.6,
    "enrich_details": true,
    "enrich_concurrency": 6,
    "use_apify_proxy": true,
    "apify_proxy_groups": ["RESIDENTIAL"],
    "apify_proxy_country": "US",
    "max_results_per_location": 100,
    "max_pages_per_location": 5
}
````

### Output

**Sample output:** [`.actor/sample-output.json`](./.actor/sample-output.json) — copy-paste-ready preview of real-looking records.

First record inline:

```json
{
  "zpid": "60123437",
  "address": "3146 Tutwiler Ave",
  "city": "Memphis",
  "state": "TN",
  "zip": "38108",
  "lat": 35.1815,
  "lng": -89.971,
  "price": 58500,
  "zestimate": 128000,
  "rent_zestimate": 497,
  "tax_assessed_value": 99840,
  "beds": 3,
  "baths": 1.0,
  "sqft": 1180,
  "lot_size_sqft": 7080,
  "year_built": 1942,
  "home_type": "SingleFamily",
  "home_status": "AUCTION",
  "listing_status_category": "auction",
  "days_on_zillow": 11,
  "price_reduction": null,
  "detail_url": "https://www.zillow.com/homedetails/60123437_zpid/",
  "img_src": "https://photos.zillowstatic.com/fp/901-house.jpg",
  "broker_name": "Keller Williams Heritage",
  "scraped_at": "2026-05-09T11:14:32Z",
  "source": "auction",
  "description": "Investor special \u2014 auction. 3 bed / 1.0 bath, 1180 sqft. Sold AS-IS. Cash or hard-money only.",
  "price_history": [
    {
      "date": "2026-04-12",
      "event": "Price change",
      "price": 58500,
      "priceChangeRate": -0.06,
      "source": "Zillow"
    },
    {
      "date": "2026-02-28",
      "event": "Listed for sale",
      "price": 73500,
      "priceChangeRate": null,
      "source": "MLS"
    },
    {
      "date": "2019-07-15",
      "event": "Sold",
      "price": 36270,
      "priceChangeRate": null,
      "source": "Public Record"
    }
  ],
  "photo_count": 8,
  "schools": [
    {
      "name": "Memphis Elementary",
      "rating": 6,
      "distance": 0.4
    },
    {
      "name": "Memphis Middle School",
      "rating": 5,
      "distance": 1.2
    },
    {
      "name": "Memphis High School",
      "rating": 7,
      "distance": 2.8
    }
  ],
  "hoa_fee": null,
  "property_tax_rate": 1.85,
  "contact_phone": "(480) 555-1011",
  "contact_agent": "Priya Shah",
  "owner_occupied": false,
  "likely_owner_occupied": false,
  "detail_enriched": true,
  "flipper_keywords": {
    "auction": [
      "auction"
    ],
    "trustee": [
      "trustee sale"
    ],
    "as-is": [
      "as-is"
    ],
    "cash": [
      "cash only"
    ]
  },
  "flip_score": {
    "score": 0.85,
    "components": {
      "keyword_score": 0.35,
      "anti_keyword_penalty": 0.0,
      "dom_score": 0.1,
      "price_drop_score": 0.0,
      "status_score": 0.15,
      "zestimate_gap_score": 0.1,
      "age_score": 0.05,
      "low_photo_score": 0.05
    },
    "matched_keywords": [
      "auction",
      "trustee sale",
      "as-is",
      "cash only"
    ],
    "anti_keywords": []
  },
  "deal_metrics": {
    "arv_estimate": 140800,
    "arv_source": "sold_comps",
    "rehab_cost_estimate": 53100,
    "estimated_rehab_months": 7,
    "exit_strategies": {
      "flip_70_rule": {
        "mao": 45460,
        "rule": "ARV * 0.70 - rehab"
      },
      "brrrr_75_rule": {
        "mao": 52500,
        "rule": "ARV * 0.75 - rehab"
      },
      "wholesale_65_rule": {
        "mao": 38420,
        "rule": "ARV * 0.65 - rehab"
      }
    },
    "gross_profit_estimate": 25936,
    "gross_margin_pct": 18.4,
    "net_profit_estimate": 22045,
    "all_in_cost_estimate": 114864,
    "monthly_holding_cost": 408,
    "total_holding_cost_estimate": 3264,
    "annual_rent_to_price": 0.1019,
    "monthly_rent_estimate": 497,
    "price_per_sqft": 49.58,
    "cash_on_cash_return_pct": 9.2
  },
  "tax_history": [
    {
      "year": 2025,
      "value": 99840,
      "tax_paid": 2368
    },
    {
      "year": 2024,
      "value": 94720,
      "tax_paid": 2329
    }
  ],
  "active_nearby_homes": [],
  "sold_nearby_homes": [
    {
      "address": "1200 Maple St",
      "sold_price": 133760,
      "sqft": 1180,
      "beds": 3,
      "sold_date": "2026-03-15"
    },
    {
      "address": "1242 Pine St",
      "sold_price": 137984,
      "sqft": 1230,
      "beds": 3,
      "sold_date": "2026-03-15"
    },
    {
      "address": "1284 Oak St",
      "sold_price": 142208,
      "sqft": 1280,
      "beds": 3,
      "sold_date": "2026-03-15"
    }
  ],
  "best_school_rating": 7,
  "contact_email": null,
  "parcel_id": "00000901-10",
  "owner_info": {
    "owner_name": "Trustee Sale (per court order)",
    "owner_first_name": "Trustee Sale",
    "owner_last_name": "(per court order)",
    "is_owner_occupied": false,
    "mailing_address": "N/A \u2014 trustee sale",
    "last_sold_price": 36270,
    "last_sold_date": "2019-07-15",
    "years_owned": 7,
    "likely_absentee": true
  },
  "distress_categories": {
    "as_is": [
      "as-is"
    ],
    "fixer": [],
    "motivated_seller": []
  },
  "neighborhood_delta": {
    "vs_neighborhood_active_pct": -18.4,
    "vs_neighborhood_ppsf_pct": -22.1,
    "below_neighborhood_median": true
  },
  "appreciation": {
    "yoy_appreciation_pct": 4.2,
    "five_year_appreciation_pct": 38.6,
    "history_span_years": 8
  },
  "estimated_owner_equity_pct": 63,
  "property_condition_tier": "heavy_rehab",
  "predicted_price_from_comps": {
    "predicted_price": 140800,
    "confidence": "medium",
    "comp_count_used": 6,
    "comp_median_ppsf": 119.32,
    "adjustments_applied": {
      "sqft_adj": 1.02,
      "year_built_adj": 0.98,
      "beds_adj": 1.0
    }
  },
  "skip_trace_record": {
    "first_name": "Trustee Sale",
    "last_name": "(per court order)",
    "full_name": "Trustee Sale (per court order)",
    "mailing_address": "N/A \u2014 trustee sale",
    "mailing_city": "Phoenix",
    "mailing_state": "AZ",
    "mailing_zip": "85001",
    "property_address": "3146 Tutwiler Ave",
    "property_city": "Memphis",
    "property_state": "TN",
    "property_zip": "38108",
    "is_absentee_owner": true,
    "years_owned": 7,
    "last_sold_price": 36270,
    "skip_trace_ready": true
  },
  "climate_risk": {
    "flood": {
      "risk_score": 2,
      "risk_level": "minor"
    },
    "fire": {
      "risk_score": 4,
      "risk_level": "moderate"
    },
    "heat": {
      "risk_score": 7,
      "risk_level": "major"
    },
    "wind": {
      "risk_score": 3,
      "risk_level": "minor"
    },
    "air": {
      "risk_score": 5,
      "risk_level": "moderate"
    }
  },
  "walk_score": 43,
  "transit_score": 29,
  "bike_score": 39,
  "climate_zone": "subtropical",
  "flood_zone": "X",
  "has_septic": false,
  "has_well": false,
  "has_solar": false
}
```

Sample record (abridged):

```json
{
    "zpid": "47129382",
    "address": "918 Park Ave",
    "city": "Atlanta",
    "state": "GA",
    "zipcode": "30314",
    "price": 92000,
    "zestimate": 187000,
    "beds": 3,
    "baths": 1,
    "sqft": 1100,
    "year_built": 1955,
    "home_status": "FOR_AUCTION",
    "listing_status_category": "auction",
    "days_on_zillow": 21,
    "flipper_keywords": ["cash only", "as-is", "investor special", "no inspection"],
    "flip_score": {
        "score": 0.78,
        "reasons": ["auction status", "list 51% of Zestimate", "older home", "distress keywords"],
        "signals": {"keywords": 0.9, "price_vs_zestimate": 0.95, "status": 0.8, "age": 0.7}
    },
    "deal_metrics": {
        "arv_estimate": 190000,
        "arv_source": "sold_comps",
        "rehab_cost_estimate": 55000,
        "exit_strategies": {
            "flip_70_rule": {"mao": 78000, "fits_rule": false},
            "wholesale_65_rule": {"mao": 68500, "fits_rule": false}
        },
        "gross_profit_estimate": 24000,
        "annual_rent_to_price": 0.182
    },
    "sold_nearby_homes": [
        {"address": "924 Park Ave", "sold_price": 195000, "sqft": 1080, "sold_date": "2026-04-09"}
    ],
    "scraped_at": "2026-05-14T12:00:00Z"
}
```

The dataset preview ships with four views: **Overview** (key columns), **Detailed** (every field with formatting hints), **Sold comps** (one row per sold comparable per auction subject - exploded via unwind, the most important view for sight-unseen underwriting), and a CSV download.

### Pricing

PAY\_PER\_EVENT.

| Event | Price | When |
|---|---|---|
| `auction_record` | $0.010 | One emitted auction record |
| `detail_enrichment` | $0.005 | When detail page was fetched |
| `high_flip_score` | $0.008 | Surcharge when `flip_score.score >= 0.6` |

Typical run with enrichment on lands at **$0.015 - $0.023 per record**.

### FAQ

**Q: Do I need cash to buy at these auctions?**
A: Sheriff and trustee sales typically require certified funds within 24-48 hours. Online auctions vary - some offer financing windows, most do not.

**Q: Can I inspect properties before bidding?**
A: Usually no. Estimate rehab generously. The `sold_comps` unwind view is your best underwriting tool because the actor cannot inspect the interior either.

**Q: What about title issues, liens, redemption periods?**
A: Liens, second mortgages, IRS tax liens, and HOA balances may survive the sale depending on state and lien priority - pull title before bidding. Several states grant the foreclosed owner a statutory redemption window after the sale.

**Q: Do online auction platforms charge fees?**
A: Yes - Auction.com, Hubzu, and similar charge buyer premiums of 5-10% on top of the winning bid. Factor this into MAO before bidding.

**Q: How fresh is auction inventory?**
A: Sheriff and trustee sales often have a defined sale date - re-run weekly per market. Online auctions refresh continuously as bids and rounds advance.

**Q: Why a residential proxy?**
A: Zillow blocks datacenter IPs aggressively. RESIDENTIAL is the minimum viable configuration. The actor defaults to it.

**Q: Does this transact properties?**
A: No. Lead generation only - no bidding, no earnest money, no legal or financial advice.

### Support

GitHub issues or DM via the Apify Store contact form.

### Found this useful?

If this actor saved you time or money, please consider leaving a quick review on the Apify Store. Reviews help other buyers find work that solves their problem and let me prioritize the features paying customers actually use. Leave a review: https://apify.com/seibs.co/property-auction-leads#reviews

# Actor input Schema

## `locations` (type: `array`):

US locations to search. Format: 'City, ST'. Example: \['Austin, TX', 'Dallas, TX', 'Phoenix, AZ']. Max 25 locations per run.

## `only_auctions` (type: `boolean`):

Restrict to auction-status listings only (recommended for this actor).

## `only_foreclosures` (type: `boolean`):

Restrict to pre-foreclosure / foreclosure listings only. Leave off for this actor unless you want auction + foreclosure intersect.

## `include_foreclosures` (type: `boolean`):

Allow pre-foreclosure and foreclosure inventory to appear alongside auctions in the result set.

## `min_price` (type: `integer`):

Minimum list price filter. Leave empty for no lower bound.

## `max_price` (type: `integer`):

Maximum list price filter. Leave empty for no upper bound.

## `min_beds` (type: `integer`):

Minimum bedroom count.

## `max_beds` (type: `integer`):

Maximum bedroom count.

## `min_baths` (type: `integer`):

Minimum bathroom count (fractional baths allowed via runner).

## `min_sqft` (type: `integer`):

Minimum living-area square footage.

## `max_sqft` (type: `integer`):

Maximum living-area square footage.

## `min_year_built` (type: `integer`):

Earliest construction year.

## `max_year_built` (type: `integer`):

Latest construction year.

## `home_types` (type: `array`):

Zillow home-type filter. SingleFamily is the most common auction inventory.

## `days_on_zillow_min` (type: `integer`):

Only return listings that have been on Zillow at least this many days. Common buckets: 30 (moderate aging), 60 (motivated seller territory), 90 (very motivated), 180+ (stale, often distressed). Leave blank to skip.

## `has_price_drop` (type: `boolean`):

Only include listings that have had at least one price reduction.

## `min_flip_score` (type: `string`):

Drop records whose computed flip score is below this threshold. 0.6+ = high-confidence flip candidate. Leave blank to emit everything. Enter as a decimal between 0.0 and 1.0 (e.g. 0.5).

## `enrich_details` (type: `boolean`):

Fetch each listing's detail page to populate description, price history, photos, nearby comps, schools, HOA, and tax data. Required for accurate flip score and ARV.

## `enrich_concurrency` (type: `integer`):

Parallel detail-page fetches. 4 is the safe default; raise cautiously. 16 is the hard ceiling.

## `use_apify_proxy` (type: `boolean`):

Route Zillow requests through Apify Proxy. Strongly recommended; running without proxy will hit blocks quickly.

## `apify_proxy_groups` (type: `array`):

Proxy groups to use. RESIDENTIAL is the most reliable against Zillow.

## `apify_proxy_country` (type: `string`):

Two-letter country code for residential proxy (e.g. 'US'). Leave blank for any.

## `max_results_per_location` (type: `integer`):

Cap on records emitted per location. Hard ceiling 100 to keep compute cost predictable.

## `max_pages_per_location` (type: `integer`):

Cap on Zillow search-result pages crawled per location. Hard ceiling 20.

## `preset_filter` (type: `string`):

Apply a flipper-strategy preset. User-supplied fields below override the preset.

## `min_lot_sqft` (type: `integer`):

Lot area floor in sqft. 43560 = 1 acre. Useful for finding subdivide/ADU opportunities.

## `max_lot_sqft` (type: `integer`):

Lot area ceiling in sqft. Leave blank for no ceiling.

## `max_hoa_fee` (type: `integer`):

Drop listings with monthly HOA above this. High HOAs kill flip math (eat into holding cost). 100 is a strict filter; 300 is moderate.

## `min_school_rating` (type: `integer`):

Drop listings whose best nearby school rates below this (impacts ARV directly). Requires enrich\_details=true.

## `sort_order` (type: `string`):

How Zillow returns results. 'best\_deals' is the default global relevance ranking; 'biggest\_discount' surfaces price-drop listings first.

## `must_include_keywords` (type: `array`):

Server-side filter: only emit listings whose description contains ALL of these case-insensitive substrings. Example: \['as-is', 'cash'].

## `must_exclude_keywords` (type: `array`):

Drop any listing whose description contains ANY of these case-insensitive substrings. Example: \['turnkey', 'renovated', 'new construction'].

## `only_absentee_owners` (type: `boolean`):

Drop listings where the owner's mailing address matches the property address. Absentee owners (landlords, out-of-state heirs) are typically more flexible on price. Requires enrich\_details=true.

## `estimated_rehab_months` (type: `integer`):

How long you expect rehab + listing + closing to take. Used to estimate total holding cost (mortgage interest + tax + utilities + HOA) during the project.

## Actor input object example

```json
{
  "locations": [
    "Austin, TX"
  ],
  "only_auctions": true,
  "only_foreclosures": false,
  "include_foreclosures": true,
  "home_types": [
    "SingleFamily"
  ],
  "has_price_drop": false,
  "min_flip_score": "",
  "enrich_details": true,
  "enrich_concurrency": 4,
  "use_apify_proxy": true,
  "apify_proxy_groups": [
    "RESIDENTIAL"
  ],
  "apify_proxy_country": "US",
  "max_results_per_location": 100,
  "max_pages_per_location": 5,
  "preset_filter": "",
  "sort_order": "best_deals",
  "must_include_keywords": [],
  "must_exclude_keywords": [],
  "only_absentee_owners": false,
  "estimated_rehab_months": 4
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

Narrow, token-efficient slice of every record. Consumer: LLM agents (Claude, GPT, LangChain tools), MCP hosts, dashboards. Property fields: address, city, state, list price, ARV, MAO (flip), flip score, distress tier, contact phone.

## `datasetItemsDetailed` (type: `string`):

All fields for every record. Consumer: humans browsing the dataset in the Apify UI, RAG ingest pipelines, and full backups. Larger payload — not recommended as a direct LLM tool response.

## `datasetItemsUnwind` (type: `string`):

Same records, but each element of the `sold_comps` array is promoted to its own row. Consumer: Zapier / Make / n8n / Google Sheets users who want one row per item, and LLM agents that prefer flat rows over nested arrays.

## `datasetItemsMcp` (type: `string`):

First 50 overview records as a clean JSON array. Wrap on the agent side in an MCP tool-call response envelope, e.g. `{ "ok": true, "data": <this array>, "meta": { "actor": "property-auction-leads", "count": <len>, "view": "overview" } }`. Consumer: MCP servers, Claude Desktop, Cursor, OpenAI Assistants tool calls.

## `datasetItemsCsv` (type: `string`):

Spreadsheet-friendly export of the overview view. Consumer: humans, sales-ops teams, Excel / Google Sheets users.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Austin, TX"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("seibs.co/property-auction-leads").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "locations": ["Austin, TX"] }

# Run the Actor and wait for it to finish
run = client.actor("seibs.co/property-auction-leads").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Austin, TX"
  ]
}' |
apify call seibs.co/property-auction-leads --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=seibs.co/property-auction-leads",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Auction Property Leads - Sheriff Sales, Trustee Sales, Online",
        "description": "Bulk Zillow auction property listings: sheriff sales, trustee sales, online foreclosure auctions. Filter by city/state, price, beds/baths/sqft. Auto-computes flip score, ARV estimate, rehab cost, MAO (70% rule). Built for cash buyers, wholesalers, flippers hunting auction inventory.",
        "version": "0.1",
        "x-build-id": "TJAfteJTYmWJ7OD8U"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/seibs.co~property-auction-leads/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-seibs.co-property-auction-leads",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/seibs.co~property-auction-leads/runs": {
            "post": {
                "operationId": "runs-sync-seibs.co-property-auction-leads",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/seibs.co~property-auction-leads/run-sync": {
            "post": {
                "operationId": "run-sync-seibs.co-property-auction-leads",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "locations"
                ],
                "properties": {
                    "locations": {
                        "title": "Locations",
                        "maxItems": 25,
                        "type": "array",
                        "description": "US locations to search. Format: 'City, ST'. Example: ['Austin, TX', 'Dallas, TX', 'Phoenix, AZ']. Max 25 locations per run.",
                        "default": [
                            "Austin, TX"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "only_auctions": {
                        "title": "Restrict to auction listings only",
                        "type": "boolean",
                        "description": "Restrict to auction-status listings only (recommended for this actor).",
                        "default": true
                    },
                    "only_foreclosures": {
                        "title": "Restrict to foreclosure listings only",
                        "type": "boolean",
                        "description": "Restrict to pre-foreclosure / foreclosure listings only. Leave off for this actor unless you want auction + foreclosure intersect.",
                        "default": false
                    },
                    "include_foreclosures": {
                        "title": "Include foreclosures in results",
                        "type": "boolean",
                        "description": "Allow pre-foreclosure and foreclosure inventory to appear alongside auctions in the result set.",
                        "default": true
                    },
                    "min_price": {
                        "title": "Min price (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum list price filter. Leave empty for no lower bound."
                    },
                    "max_price": {
                        "title": "Max price (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum list price filter. Leave empty for no upper bound."
                    },
                    "min_beds": {
                        "title": "Min beds",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum bedroom count."
                    },
                    "max_beds": {
                        "title": "Max beds",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum bedroom count."
                    },
                    "min_baths": {
                        "title": "Min baths",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum bathroom count (fractional baths allowed via runner)."
                    },
                    "min_sqft": {
                        "title": "Min sqft",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum living-area square footage."
                    },
                    "max_sqft": {
                        "title": "Max sqft",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum living-area square footage."
                    },
                    "min_year_built": {
                        "title": "Min year built",
                        "minimum": 1700,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Earliest construction year."
                    },
                    "max_year_built": {
                        "title": "Max year built",
                        "minimum": 1700,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Latest construction year."
                    },
                    "home_types": {
                        "title": "Home types",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Zillow home-type filter. SingleFamily is the most common auction inventory.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "SingleFamily",
                                "Condo",
                                "Townhouse",
                                "MultiFamily",
                                "Manufactured",
                                "LotsLand"
                            ]
                        },
                        "default": [
                            "SingleFamily"
                        ]
                    },
                    "days_on_zillow_min": {
                        "title": "Days on Zillow (min)",
                        "minimum": 0,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Only return listings that have been on Zillow at least this many days. Common buckets: 30 (moderate aging), 60 (motivated seller territory), 90 (very motivated), 180+ (stale, often distressed). Leave blank to skip."
                    },
                    "has_price_drop": {
                        "title": "Has price drop",
                        "type": "boolean",
                        "description": "Only include listings that have had at least one price reduction.",
                        "default": false
                    },
                    "min_flip_score": {
                        "title": "Min flip score (0.0-1.0)",
                        "type": "string",
                        "description": "Drop records whose computed flip score is below this threshold. 0.6+ = high-confidence flip candidate. Leave blank to emit everything. Enter as a decimal between 0.0 and 1.0 (e.g. 0.5).",
                        "default": ""
                    },
                    "enrich_details": {
                        "title": "Enrich listing detail pages",
                        "type": "boolean",
                        "description": "Fetch each listing's detail page to populate description, price history, photos, nearby comps, schools, HOA, and tax data. Required for accurate flip score and ARV.",
                        "default": true
                    },
                    "enrich_concurrency": {
                        "title": "Enrichment concurrency",
                        "minimum": 1,
                        "maximum": 16,
                        "type": "integer",
                        "description": "Parallel detail-page fetches. 4 is the safe default; raise cautiously. 16 is the hard ceiling.",
                        "default": 4
                    },
                    "use_apify_proxy": {
                        "title": "Use Apify Proxy",
                        "type": "boolean",
                        "description": "Route Zillow requests through Apify Proxy. Strongly recommended; running without proxy will hit blocks quickly.",
                        "default": true
                    },
                    "apify_proxy_groups": {
                        "title": "Apify Proxy groups",
                        "type": "array",
                        "description": "Proxy groups to use. RESIDENTIAL is the most reliable against Zillow.",
                        "default": [
                            "RESIDENTIAL"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "apify_proxy_country": {
                        "title": "Apify Proxy country code",
                        "type": "string",
                        "description": "Two-letter country code for residential proxy (e.g. 'US'). Leave blank for any.",
                        "default": "US"
                    },
                    "max_results_per_location": {
                        "title": "Max results per location",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Cap on records emitted per location. Hard ceiling 100 to keep compute cost predictable.",
                        "default": 100
                    },
                    "max_pages_per_location": {
                        "title": "Max search pages per location",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Cap on Zillow search-result pages crawled per location. Hard ceiling 20.",
                        "default": 5
                    },
                    "preset_filter": {
                        "title": "Preset filter (optional)",
                        "enum": [
                            "",
                            "conservative_flipper",
                            "aggressive_flipper",
                            "brrrr_investor",
                            "wholesaler"
                        ],
                        "type": "string",
                        "description": "Apply a flipper-strategy preset. User-supplied fields below override the preset.",
                        "default": ""
                    },
                    "min_lot_sqft": {
                        "title": "Min lot size (sqft)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Lot area floor in sqft. 43560 = 1 acre. Useful for finding subdivide/ADU opportunities."
                    },
                    "max_lot_sqft": {
                        "title": "Max lot size (sqft)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Lot area ceiling in sqft. Leave blank for no ceiling."
                    },
                    "max_hoa_fee": {
                        "title": "Max HOA fee per month ($)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop listings with monthly HOA above this. High HOAs kill flip math (eat into holding cost). 100 is a strict filter; 300 is moderate."
                    },
                    "min_school_rating": {
                        "title": "Min school rating (1-10)",
                        "minimum": 1,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Drop listings whose best nearby school rates below this (impacts ARV directly). Requires enrich_details=true."
                    },
                    "sort_order": {
                        "title": "Sort order",
                        "enum": [
                            "best_deals",
                            "newest",
                            "lowest_price",
                            "biggest_discount",
                            "largest_sqft",
                            "oldest_built"
                        ],
                        "type": "string",
                        "description": "How Zillow returns results. 'best_deals' is the default global relevance ranking; 'biggest_discount' surfaces price-drop listings first.",
                        "default": "best_deals"
                    },
                    "must_include_keywords": {
                        "title": "Required keywords (must all appear in description)",
                        "type": "array",
                        "description": "Server-side filter: only emit listings whose description contains ALL of these case-insensitive substrings. Example: ['as-is', 'cash'].",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "must_exclude_keywords": {
                        "title": "Excluded keywords (drop if any appear)",
                        "type": "array",
                        "description": "Drop any listing whose description contains ANY of these case-insensitive substrings. Example: ['turnkey', 'renovated', 'new construction'].",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "only_absentee_owners": {
                        "title": "Only absentee owners",
                        "type": "boolean",
                        "description": "Drop listings where the owner's mailing address matches the property address. Absentee owners (landlords, out-of-state heirs) are typically more flexible on price. Requires enrich_details=true.",
                        "default": false
                    },
                    "estimated_rehab_months": {
                        "title": "Estimated rehab months (for holding cost)",
                        "minimum": 1,
                        "maximum": 18,
                        "type": "integer",
                        "description": "How long you expect rehab + listing + closing to take. Used to estimate total holding cost (mortgage interest + tax + utilities + HOA) during the project.",
                        "default": 4
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
